Proteus AI · 可扩展的个人与团队 AI 助理平台

Capability Map

能力地图

不是某一个固定模型或页面,而是一个可组合的 Agent 运行时:模型配置可在管理页面维护,工具由后端自动发现,技能按 SKILL.md 渐进加载。

智能对话

多轮上下文、流式回复、文件分析、工具调用与用户输入交互,支持随时停止任务。

智能体

Chat、Task、Workflow、深度研究、代码执行、浏览器、MCP、Custom、Agent Group 九种模式。

工具系统

搜索、网页抓取、代码执行、Shell、文件/S3、数据库、记忆、知识、MCP 等,后端自动发现注册。

研究与知识

深度研究与多任务研究、知识库与 Wiki 编译、向量检索、长期记忆与工具/SOP 记忆。

可视化工作流

Workflow Studio、模板、Agent/LLM 路由、人工审批、并行 fork/join、循环与执行回放。

自动化

长程任务、定时任务、结果历史、通知与渠道推送,让 Agent 持续运行在真实工作场景。

扩展与集成

SKILL.md 技能、MCP Server、飞书渠道、OpenAI-compatible API 与 OpenClaw Gateway。

安全与治理

JWT/Session、角色菜单权限、用户归属校验、工具安全审计、操作日志与受限执行沙箱。

多端客户端

React 19 Web SPA、Kotlin/Compose Android 客户端、可独立直连 LLM 的命令行 CLI。

System Topology

系统架构

以核心 FastAPI 应用为中心的组合式 Agent 平台,Nginx 统一 HTTP 入口,基础设施各司其职。

客户端与外部入口

Web SPA Android CLI 飞书渠道 OpenAI 兼容客户端

统一入口

Nginx HTTP 80 / HTTPS 443

核心服务

Proteus Core FastAPI · :8000 Server 兼容服务 · :8080 Sandbox 受限执行 · :8888 Voice Whisper / TTS

基础设施

PostgreSQL 业务持久化 Redis 队列 / 状态 / 流 S3 / MinIO 对象与资源 LLM OpenAI-compatible

Multi-Platform

多端入口

同一个可组合运行时,覆盖浏览器、手机、终端与外部协作渠道。

Web SPA

React 19 + TypeScript + Vite,含 Workflow Studio 与完整管理台

React 19

Android

Kotlin/Compose 客户端,Retrofit REST + OkHttp WebSocket

Kotlin

CLI

本地 ReAct/工具智能体,直连 OpenAI-compatible LLM,独立运行

TypeScript

渠道集成

飞书渠道推送与 OpenAI-compatible API、OpenClaw Gateway 接入

Feishu / MCP

Quick Start

快速开始

一键启动 Web、核心 API、沙箱与 Nginx 等全部服务。

bash — proteus-ai

# 克隆并配置
$ git clone https://github.com/alishangtian/proteus-ai.git
$ cd proteus-ai
$ cp .env.example .env

# 一键启动全部服务(Web 默认 preview 模式)
$ ./start.sh

# Web:            https://localhost
# Proteus API 文档: http://127.0.0.1:8000/docs

准备环境
Python 3.11+、Node.js 18+,以及核心业务所需的 PostgreSQL 与 Redis。
按目录配置
根 .env 供编排脚本读取,各子项目从自己的 .env 加载数据库、LLM、存储等配置。
一键启动
./start.sh 协调 API、Sandbox、Web、Nginx 与可选 Voice;需要兼容服务时 --include server。
开始使用
访问 Web 控制台对话、编排工作流、管理知识与技能,或用 CLI 在终端直接驱动智能体。

更多部署方式 支持 --only / --skip 按服务启停、Docker Compose 启动 MinIO、语音服务独立编排,详见仓库 scripts/deploy 部署指南。