一人软件公司的 AI 执行平台 | solopreneur 开源项目介绍

系列：《solopreneur 从零到一》第 1 期
GitHub：https://github.com/lllooollpp/solopreneur-.git
系列目录：查看完整系列

---

你有没有遇到过这些问题？

• Claude/ChatGPT 跟你聊了一堆方案，但你自己还是要一行一行地敲代码
• AI 写了一段逻辑，但它不知道你的数据库地址、私服 URL、接口规范
• 你的 Cursor/Copilot 每次只能处理当前文件，无法跨项目、跨角色协作
• 一个功能需要产品分析 → 架构设计 → 编码 → 测试 → 部署，你一个人疲于奔命

solopreneur 就是为解决这些问题而生的。

---

什么是 solopreneur？

solopreneur 是一个开源的 AI Agent 执行平台，核心定位是：

🐈 帮助一人软件公司（Solo Founder / Solo Dev）用 AI 完成从需求到交付的完整工程流程。

它不是一个聊天工具，而是一个可以真正执行的 AI 工程系统：

• AI 能读写你的文件、执行 Shell 命令、搜索网页
• AI 知道你的项目数据库地址、接口规范、环境配置
• 不同的工程任务由不同角色的 Agent 负责（产品/架构/开发/测试/运维）
• 多个 Agent 可以并行协作，像一支小团队

一句话定义：solopreneur = 可执行的 AI 工程师团队，常驻在你的项目里。

---

核心能力一览

🤖 多角色 Agent 系统

内置软件工程全流程角色：

Agent	职责
product_manager	需求分析、PRD 撰写
architect	架构设计、技术选型
developer	编码实现（含执行保障，真正写文件）
code_reviewer	代码审查
tester	测试策略、自动化测试
devops	CI/CD、容器化、部署

每个角色都知道自己的边界，不会越权。developer 负责写代码，tester 负责跑测试，分工明确。

🔌 多 LLM 支持

通过 LiteLLM 统一接入：

• OpenRouter（Claude、GPT-4o 等百余模型）
• Anthropic / OpenAI / Gemini / Groq
• 火山引擎（智谱 GLM-4 系列）
• vLLM / Ollama 本地模型
• GitHub Copilot（多账号 Token 池 + 429 自动熔断）

🧰 强大的工具系统

Agent 内置的工具不是"建议执行"，而是真正执行：

read_file / write_file / edit_file  ← 读写项目文件
exec                                ← 执行 Shell 命令（跑测试、编译、部署）
web_search / web_fetch              ← 搜索和抓取网页
spawn / delegate                    ← 创建子 Agent / 委派给专业角色
run_workflow                        ← 启动多 Agent 协作流水线
get_project_env / set_project_env   ← 读写项目环境配置

📁 项目级上下文

你的项目A：
  DB_HOST=192.168.1.100（MySQL 主库）
  NEXUS_URL=https://nexus.company.com（私服）
  API_BASE=https://api.company.com（网关）

你的项目B：
  DB_HOST=10.0.0.50（测试库）
  REDIS_URL=redis://localhost:6379

AI 执行任务时自动感知项目环境，不需要每次重复告诉它。

🧠 语义记忆系统

• 每日笔记：YYYY-MM-DD.md，记录当天的操作和思考
• 长期记忆：MEMORY.md，持久化的项目/用户上下文
• 向量检索：基于 all-MiniLM-L6-v2 的语义搜索，从历史记忆中自动召回相关信息

🔄 工作流引擎

4 个预定义流水线，覆盖日常工程场景：

feature   需求分析 → 架构设计 → 编码 → 代码审查 → 测试
bugfix    问题分析 → 修复审查 → 回归测试
review    代码审查 → 测试建议
deploy    部署前测试 → 部署配置

---

架构设计

           ┌─────────────────────────────────────────┐
           │           Web UI / Mobile UI            │
           │    项目管理 · 实时对话 · 调用链路追踪     │
           └──────────────────┬──────────────────────┘
                              │ WebSocket / REST
           ┌──────────────────▼──────────────────────┐
           │              FastAPI Gateway             │
           │   /api/v1 · /ws/chat · /ws/events       │
           └──────┬──────────────────────┬───────────┘
                  │                      │
     ┌────────────▼─────┐    ┌───────────▼──────────┐
     │   Agent Loop     │    │   Workflow Engine    │
     │  工具调用 · 上下文 │    │  多 Agent 流水线     │
     │  压缩 · 超时控制  │    │  auto / step 模式   │
     └──────┬───────────┘    └──────────────────────┘
            │
    ┌───────▼────────────────────────────────┐
    │            Tool System                 │
    │  文件 · Shell · Web · spawn · delegate  │
    └───────┬────────────────────────────────┘
            │
    ┌───────▼─────────────────────────────────┐
    │           Provider Layer               │
    │  LiteLLM · Copilot Token Pool          │
    │  OpenRouter · Anthropic · vLLM · ...   │
    └─────────────────────────────────────────┘

---

和 Cursor / Copilot 有什么区别？

维度	Cursor / Copilot	solopreneur
核心场景	IDE 代码补全、单文件编辑	完整工程任务执行
项目上下文	当前文件/仓库	项目环境变量 + 记忆系统
执行能力	建议代码（你来执行）	直接写文件、跑命令
角色分工	单一助手	多角色 Agent 团队
工作流	无	多 Agent 协作流水线
渠道接入	IDE 内	Web / WhatsApp / Telegram / 企业微信
费用	订阅制	开源自部署，用自己的 Key

---

快速体验

# 安装
pip install solopreneur-ai

# 初始化
solopreneur onboard

# 编辑配置，填入你的 LLM Key
# ~/.solopreneur/config.json

# 命令行对话
solopreneur agent -m "帮我分析一下 src/main.py 的架构问题"

# 启动 Web UI
solopreneur gateway
# 访问 http://localhost:8000

---

项目现状

• 开源协议：MIT
• 语言：Python 3.11+（后端）+ Vue 3 + TypeScript（前端）
• 部署方式：本地 / Docker / 服务器
• 活跃维护：持续迭代，每周更新

---

系列目录

本系列共 8 期，覆盖 solopreneur 的从安装到高级用法：

期数	主题
第 1 期	项目介绍 & 架构总览（本篇）
第 2 期	5 分钟快速上手：安装配置与第一次对话
第 3 期	多 LLM 配置：OpenRouter / 本地模型 / 火山引擎
第 4 期	GitHub Copilot 白嫖指南：多账号 Token 池详解
第 5 期	Agent 系统深度解析：角色定义、工具隔离与执行保障
第 6 期	工作流引擎：多 Agent 协作流水线实战
第 7 期	移动端 Web UI：手机上管理你的 AI 团队
第 8 期	企业微信/Telegram 接入：把 AI 接进聊天群

---

如果你也是一个人在做软件，欢迎 Star ⭐ 和关注，一起探索 AI + 独立开发的边界。

GitHub：https://github.com/lllooollpp/solopreneur-.git