Skip to content
AnacondaKCPublic

About

使用东方财富妙想的AI模拟炒股平台

Topics

Resources

Stars

187 stars

Watchers

3 watching

Forks

Repository files navigation

Aniu logo

Aniu

科技牛牛,带你狠狠干 A 股

面向 A 股研究与模拟交易的本地交易智能体工作台

CI GitHub stars GitHub forks GitHub issues

Python 3.12+ React 19 FastAPI SQLite

核心能力 · 界面一览 · 快速开始 · Docker 部署

Aniu 投资总览页面

把行情、研究、工具调用、模拟组合和交易记忆放进一条可追踪的工作流。


项目简介

Aniu(Aniubot)是一个本地优先的股票交易智能体系统。它以 A 股行情和模拟组合为工作对象,把模型推理、市场数据工具、分阶段任务、运行轨迹、账户状态与可演化记忆连接起来,提供一个适合反复研究、观察和复盘的工作台。

项目当前面向研究与模拟交易场景,不承诺实盘下单能力,也不构成投资建议。

核心能力

模块 能力说明
投资总览 聚合模拟组合的账户资产、持仓、委托和收益表现,并提供 A 股行情总览。
任务运行 手动或按计划启动分阶段策略任务,查看研究、决策、交易、总结等阶段的运行状态。
实时轨迹 通过事件流展示思考步骤、工具调用、阶段报告、耗时和 Token 统计,方便定位每次运行发生了什么。
市场数据工具 统一管理实时行情、K 线、分时、排行、资金流、基本面、研报与资讯等数据工具。
记忆梦境 保存可复用的交易经验,记录读取/写入/修改活动,并按计划整理每日运行报告。
阶段与模型配置 为不同运行阶段配置提示词、模型渠道、模型参数和选择策略。
任务调度 配置交易时段内的自动运行计划,以及账户刷新和记忆整理任务。
本地优先 Token 登录、SQLite 持久化、敏感配置管理和 Docker 数据卷均以单机部署为默认路径。

一条完整工作流

行情与账户数据
      ↓
分阶段智能体运行
      ↓
工具调用与实时轨迹
      ↓
模拟组合与运行报告
      ↓
记忆库与夜间整理

界面一览

以下截图来自项目工作台,数据为模拟或示例数据,仅用于展示界面和交互流程。

行情总览页面

行情总览
指数、涨跌分布、资金流与行业/概念排行

任务运行页面

任务运行
运行记录、阶段进度与策略报告

工具管理页面

工具管理
数据工具、系统工具与调用日志目录

工具调用页面

工具调用
展开查看模型思考、工具参数和返回结果

记忆梦境页面

记忆梦境
整理运行经验,维护可检索的交易记忆

投资总览页面

账户总览
资产、持仓、委托与组合变化集中呈现

技术栈

层次 主要技术
前端 React 19、TypeScript、Vite、React Router、Tailwind CSS、Radix UI、TanStack Query
后端 Python 3.12+、FastAPI、Uvicorn、Pydantic、SQLAlchemy 2、aiosqlite
智能体与模型 OpenAI SDK、Anthropic SDK、分阶段运行编排、SSE 事件流
数据与调度 股票数据适配器、SQLite、APScheduler、运行与调用审计记录
工程工具 OpenAPI Typescript、Vitest、Testing Library、ESLint、Prettier、Ruff、Mypy、Docker

快速开始

前提条件

  • Python 3.12+
  • Node.js 22+ 与 npm
  • Git 与 curl(Linux 一键安装需要)
  • Docker(仅 Docker 部署需要)

Linux 发行版还需要提供 Python 的 venv 模块;Debian/Ubuntu 通常对应 python3-venv 软件包。

Linux 一键安装

在已安装 Git、Python 3.12+、Node.js 22+、npm 和 curl 的 Linux 主机上,可以直接拉取源码、安装依赖并启动服务:

curl -fsSL https://raw.githubusercontent.com/AnacondaKC/Aniu/main/install-linux.sh | bash

默认安装到 $HOME/Aniu。自定义安装目录或分支:

curl -fsSL https://raw.githubusercontent.com/AnacondaKC/Aniu/main/install-linux.sh | bash -s -- --dir "$HOME/aniu" --branch main

如果目标目录已经是同一仓库且工作区干净,脚本会以 fast-forward 方式更新;检测到未提交改动时会停止,不覆盖本地文件。脚本完成依赖安装后会以前台方式启动 Aniu,按 Ctrl+C 停止服务。

远程脚本会直接在当前主机执行。生产环境建议先下载并审阅脚本,再运行:

curl -fsSL https://raw.githubusercontent.com/AnacondaKC/Aniu/main/install-linux.sh -o /tmp/aniu-install-linux.sh
bash /tmp/aniu-install-linux.sh --help

一键源码运行

在仓库根目录执行:

# 安装后端依赖、前端依赖并构建前端
./install.sh

安装脚本会创建 .aniu/local/.venv,安装锁定依赖,构建前端,并以前台方式启动统一服务。默认访问地址:http://127.0.0.1:8000。

首次运行时:

  1. 打开登录页,首次设置一个至少 8 个字符的访问 Token。
  2. 进入「主要设置 → 妙想设置」,填写项目所需的妙想 API 密钥。
  3. 在「渠道模型」配置可用模型,在「阶段设置」为不同阶段选择模型与提示词。
  4. 需要自动执行时,在「交易任务」中配置计划;源码启动时设置 ANIU_ENABLE_SCHEDULER=1。
ANIU_ENABLE_SCHEDULER=1 ./install.sh

首次设置身份只允许来自本机回环地址。局域网部署请在启动前通过 ANIU_AUTH_TOKEN 预先设置 Token。

本地开发

后端和前端分别运行,适合边改边调试:

# 终端一:创建后端环境并安装开发依赖
python3 -m venv .aniu/local/.venv
./scripts/install_python_dev.sh .aniu/local/.venv/bin/python
.aniu/local/.venv/bin/python -m backend.serve --reload

# 终端二:安装并启动前端
npm --prefix frontend ci --include=dev
npm --prefix frontend run dev

默认地址:

Vite 会将 /api 和 /health 代理到后端 8000 端口,可通过 VITE_BACKEND_PROXY 覆盖代理目标。

需要局域网访问时,显式开启 LAN 模式并提供精确的 Host 白名单:

.aniu/local/.venv/bin/python -m backend.serve --lan --allowed-host 192.168.1.20

局域网环境请在服务前使用 HTTPS 反向代理或 SSH 隧道,不要直接暴露 HTTP 登录端点。

Docker 部署

Compose 默认只将服务绑定到 127.0.0.1:8000,并使用命名卷 aniu-data 保存数据库、密钥和运行历史。

mkdir -p .aniu/local
cp .env.example .aniu/local/.env

docker compose --env-file .aniu/local/.env up -d --build
docker compose --env-file .aniu/local/.env ps
curl http://127.0.0.1:8000/health/ready

访问 http://127.0.0.1:8000 即可使用容器内构建的前端。

使用宿主机目录保存数据

默认命名卷最省心;如需把数据保存在当前目录,可将服务卷改为:

volumes:
  - ./data:/app/data

Release 镜像会在启动时自动修复 ./data 的挂载根目录权限,然后以非 root 用户运行应用;首次使用无需手动执行 chown。该目录会保存数据库、登录密钥和日志,勿提交到 Git。若使用不支持 Linux chown 的网络盘或特殊文件系统,仍应改用 Docker 命名卷。

GitHub Release 镜像

每次发布正式 GitHub Release,GitHub Actions 会构建并推送 Linux amd64 镜像到 ghcr.io/anacondakc/aniu。镜像包含 Release 原始标签、可解析的语义版本标签和提交 SHA 标签;正式版还会更新 latest,预发布版不会更新 latest。

使用指定 Release 镜像部署:

export ANIU_IMAGE=ghcr.io/anacondakc/aniu:v1.0.3
docker pull "$ANIU_IMAGE"
docker compose --env-file .aniu/local/.env up -d --no-build --force-recreate

首次发布后,需要在 GitHub Packages 将 aniu 容器包设置为 Public,外部用户才能无需登录拉取镜像。停止服务但保留数据:

docker compose --env-file .aniu/local/.env down

不要随意使用 docker compose down -v,删除卷会同时删除配置、密钥和运行历史。容器默认启用调度器;SQLite 与进程内调度器适合单实例运行。

配置

Compose 的基础模板位于 .env.example,真正的密钥建议只放在被 Git 忽略的 .aniu/local/.env 中。

变量 说明 默认行为
ANIU_AUTH_TOKEN 固定登录 Token,至少 8 个字符 未设置时可在本机首次登录页设置
ANIU_PORT 服务端口 8000
ANIU_BIND_ADDRESS Compose 端口绑定地址 127.0.0.1
ANIU_LAN 是否启用局域网模式 源码默认关闭,Docker 模板默认关闭
ANIU_ALLOWED_HOSTS LAN 模式允许的 Host 列表 填 * 时接受任意 Host;仅限可信内网使用
ANIU_CORS_ORIGINS 独立前端访问后端时的来源列表 本地服务地址
ANIU_ENABLE_SCHEDULER 是否启用进程内调度器 源码默认关闭,Docker 默认开启
ANIU_DATA_DIR 数据库、密钥和日志目录 源码为 .aniu,容器为 /app/data
ANIU_DATABASE_URL 可选的数据库连接地址 使用 SQLite
ANIU_MASTER_SECRET_KEY 固定敏感配置加密密钥 未设置时由本地运行时管理
ANIU_MASTER_SECRET_KEY_PREVIOUS 密钥轮换时的旧密钥 可选

模型渠道与妙想配置推荐在登录后的设置页面保存,不要写入 VITE_* 变量、前端构建产物或 URL。

API 入口

后端 API 统一使用 /api/aniu 前缀,所有业务接口都要求已认证会话。

GET  /health
GET  /health/live
GET  /health/ready

POST /api/aniu/auth/setup
POST /api/aniu/auth/login
POST /api/aniu/auth/logout

GET  /api/aniu/account/dashboard
GET  /api/aniu/market/overview
POST /api/aniu/runs/start
GET  /api/aniu/runs
GET  /api/aniu/settings
GET  /api/aniu/schedules
GET  /api/aniu/memories
GET  /api/aniu/memory-dreams

任务详情通过 SSE 推送运行事件;完整请求/响应模型可在服务启动后打开 http://127.0.0.1:8000/docs 查看。

质量检查

# 后端
.aniu/local/.venv/bin/python -m ruff check backend scripts
.aniu/local/.venv/bin/python -m mypy backend
.aniu/local/.venv/bin/python -m pytest backend/tests -q

# 前端
npm --prefix frontend test -- --run
npm --prefix frontend run lint -- --max-warnings=0
npm --prefix frontend run format:check
npm --prefix frontend run build

# OpenAPI 契约
npm --prefix frontend run api:generate
npm --prefix frontend run api:check

项目结构

Aniu/
├── backend/
│   ├── api/          # HTTP、SSE 与 OpenAPI 适配
│   ├── business/     # 业务用例与领域模型
│   ├── infra/        # 数据库、仓库、调度器、Worker 与外部集成
│   ├── bootstrap/    # 应用组装、生命周期与运行时配置
│   ├── agent/        # Agent 核心
│   ├── llm/          # LLM 客户端与协议
│   └── stock_api/    # 股票数据接口适配
├── frontend/
│   ├── src/components/ # 通用布局与 UI 组件
│   ├── src/features/   # 认证、总览、运行、记忆与设置功能
│   └── src/generated/  # OpenAPI 生成的类型
├── scripts/          # 开发与契约脚本
├── install-linux.sh  # Linux 一键拉取、安装与启动
├── docs/screenshots/ # README 页面截图
├── Dockerfile
├── compose.yaml
├── install.sh
├── pyproject.toml
└── requirements.lock

.aniu/ 只用于本地运行数据、虚拟环境、缓存和日志,不是新克隆项目所需提交的源码目录。

安全与使用边界

  • 不要把 Token、模型 API Key、妙想密钥或主密钥提交到 Git。
  • 不要通过 VITE_* 变量传递后端秘密;这类变量会进入前端开发或构建环境。
  • LAN 模式可配置精确的 ANIU_ALLOWED_HOSTS,或在可信内网显式设置为 *;外网访问应通过 HTTPS 反向代理或 SSH 隧道保护登录流量。
  • 妙想及行情服务受其自身额度、稳定性和使用条款约束。
  • 项目用于研究与模拟交易,不提供投资建议;请在充分验证后决定是否采用任何分析结果。

致谢

感谢 LinuxDo、FastAPI、React、Vite、Tailwind CSS以及其他开源项目提供的基础设施。Aniu 同时接入妙想和公开行情数据适配器,相关服务请遵循各自的使用条款。

许可证

本项目采用 Apache License 2.0 开源。

Star History

Star History Chart

About

使用东方财富妙想的AI模拟炒股平台

Topics

Resources

Stars

187 stars

Watchers

3 watching

Forks

Releases

Packages

Contributors

Languages