项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 2070
使用教程
环境要求
- 已安装 Docker,版本需大于 20.0
- 准备一个 OpenAI API Token(可在 beta.openai.com 申请)
- 预留一个本地目录用于挂载,保存聊天记录、日程等个人数据
- 首次运行需要在交互式终端中完成初始化并填写信息
安装与启动步骤
-
1检查 Docker 环境
在控制台执行命令确认已安装 Docker 且版本号大于 20.0,否则需先参考官方文档安装 Docker。
docker -version -
2拉取 OpenDAN 镜像
从 Docker Hub 拉取官方提供的 OpenDAN 内测版镜像 paios/aios:latest,这是官方推荐的安装方式。
docker pull paios/aios:latest -
3首次运行并初始化
必须带 -it 参数进入交互式初始化,并按提示输入信息;-v 将本地目录挂载到容器 /root/myai 保存个人数据。
docker run -v /your/local/myai/:/root/myai --name aios -it paios/aios:latest -
4再次启动实例
首次创建并初始化完成后,后续直接用 docker start 重新进入交互式界面,无需再执行 run 命令。
docker start -ai aios -
5以无界面服务模式启动
如果想让 OpenDAN 以后台服务模式(NO UI)运行,启动时不要带 -ai 参数即可。
docker start aios
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
OpenAI API Token | 是 | 首次初始化时按提示输入,用于接入 OpenAI 模型;没有可向他人借用或加入内测群获取 | sk-xxxxxxxxxxxxxxxx |
本地挂载目录 | 是 | 挂载到容器 /root/myai,用于持久化保存 agent 聊天记录、日程等个人数据 | /your/local/myai/ |
容器名称 | 否 | --name 指定的 Docker 实例名,便于后续 start 操作,可自定义 | aios |
如何确认成功
执行 docker run -it 后成功进入 OpenDAN 初始化交互流程并按提示填写信息,即说明启动成功;之后用 docker start -ai aios 能再次进入。
常见问题
Q:为什么首次运行必须加 -it 参数?
A:首次运行需要初始化并在过程中输入信息,缺少 -it 无法进行交互式输入,导致初始化无法完成。
Q:没有 OpenAI API Token 怎么办?
A:README 建议向身边朋友借用临时 token,或加入 OpenDAN 内测体验群,官方会不定期发放有额度和有效期限制的免费 token。
Q:为什么要挂载本地目录?
A:OpenDAN 运行中会产生聊天历史、日程等个人数据,挂载本地磁盘到 /root/myai 可保证这些数据持久保存不丢失。
Q:无界面模式怎么启动?
A:使用 docker start aios,不带 -ai 参数即以服务模式(NO UI)在后台运行。
注意事项
- OpenDAN 仍处于早期阶段,后续版本(如 0.5.2)可能有较大变化,README 明确提示可能有重大改动。
- 官方推荐使用 Docker 方式安装;源码安装可能遇到 Python 依赖问题,仅在需要二次开发时选择。
- 申请 OpenAI API Token 对新用户可能存在门槛,注意 token 有最大消费额度和有效时间限制。
核心亮点
- 统一管理多个AI模型和代理,避免工具碎片化
- 本地优先设计,保护隐私且支持离线使用
- 提供类似操作系统的抽象层,扩展性强
不足之处
- 项目仍处于早期阶段,文档和社区生态待观察
- 对非技术用户门槛较高,配置复杂
适用场景
- 个人AI助手集成,统一调度多个模型
- 本地私有化部署AI服务,保护数据隐私
- 开发者构建自定义AI代理工作流
替代项目
Dify、Flowise、AutoGPT
上一篇:WorkBuddyGuide
下一篇:agent-safehouse
同类项目推荐
iwe
开源
把 Markdown 笔记变成 AI 可用的知识图谱,让编辑器与智能体共享记忆
Markdown knowledge graph — LSP for your editor, CLI + MCP memory for your AI agents
Awesome-GUI-Agent
开源
一站式获取 GUI 智能体论文与资源,快速入门研究
A curated list of papers and resources for multi-modal Graphical User Interface (GUI···
yomo
开源
把 AI 智能体部署到边缘,秒级响应,数据不出域
Serverless AI Agent Framework with Geo-distributed Edge AI Infra.
OpenAgents
开源
在真实场景中快速搭建和部署语言智能体,开箱即用
[COLM 2024] OpenAgents: An Open Platform for Language Agents in the Wild
ai-agents-skills
开源
给编程智能体配一套可复用技能包,少写重复提示词
AI Agent Skills Repository - A curated collection of specialized skills for AI codin···
MCP-Universe
开源
一站式训练评测智能体工具调用能力
MCP-Universe is a comprehensive framework designed for RL training, benchmarking, an···
aichat
开源
一个终端搞定所有大模型,聊天、写命令、查文档全自动
All-in-one LLM CLI tool featuring Shell Assistant, Chat-REPL, RAG, AI Tools & Agents···
pisper
开源
多智能体并行干活,桌面终端手机都能用
Multi-agent app for parallel sessions, tools, memory, workflows, desktop, terminal, ···
flue
开源
让 AI 智能体在沙箱里安全动手干活
The sandbox agent framework.
