---
## 快速入门
> `dev` 是默认分支，首先获取最新的更改。如果您想要更精心策划的分支，请使用 [`main`](https://github.com/odysseus-dev/odysseus/tree/main)。
````bash
git 克隆 https://github.com/odysseus-dev/odysseus.git
奥德修斯CD
cp .env.example .env
docker compose up -d --build
````
当容器正常时打开“http://localhost:7000”。第一个管理员密码打印在“docker compose logs odysseus”中。
本机安装、GPU 说明、Windows/macOS 说明、HTTPS 和配置均位于 [设置指南](docs/setup.md) 中。
## 特点
- **聊天 + 代理** — 本地/API 模型、工具、MCP、文件、shell、技能和内存。
- **Cookbook** — 硬件感知模型推荐、下载和服务。
- **深度研究** — 多步骤网络研究，包括源代码阅读和报告生成。
- **比较** — 盲目并排模型测试和综合。
- **文档** — 具有 AI 编辑、建议、Markdown、HTML、CSV 和语法突出显示功能的写作优先编辑器。
- **电子邮件** — IMAP/SMTP 收件箱，包含分类、标签、摘要、提醒和回复草稿。
- **笔记、任务 + 日历** — 提醒、待办事项、计划代理任务和 CalDAV 同步。
- **附加** — 图库/图像编辑器、主题、上传、网络搜索、预设、会话和 2FA。
## 演示
完整的悬停游戏游览位于登陆页面：[`docs/index.html`](docs/index.html)。
## 贡献
欢迎帮助。最好的切入点是全新安装测试、提供商设置错误、移动/编辑器完善、文档和小型重点重构。请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 和 [ROADMAP.md](ROADMAP.md)。
## 安全
Odysseus 是一个具有强大本地工具的自托管工作区。保持身份验证启用，将私有数据保留在 Git 之外，并且不要公开暴露原始模型/服务端口。部署详细信息位于[设置指南](docs/setup.md#security-notes)。
## 明星历史
<图片>