javded-itres/Holix
GitHub: javded-itres/Holix
Holix 是一个具备持久化记忆、技能系统和多接口的自我进化 AI Agent，能从任务中学习并积累可复用能力。
Stars: 10 | Forks: 2
# Holix — 自我进化的 AI Agent
**Holix** 是一个具备持久化记忆、技能系统、工具调用、MCP 集成以及多种接口（CLI、TUI、API 网关和 Telegram）的自我进化的 AI Agent。
[](https://pypi.org/project/Holix/)
[](https://python.org)
[](LICENSE)
[](docs/README.md)
**网站:** [holix-agent.ru](https://holix-agent.ru) · **PyPI:** [Holix](https://pypi.org/project/Holix/) · **GitHub:** [javded-itres/Holix](https://github.com/javded-itres/Holix) · **Telegram:** [@helix_agent](https://t.me/helix_agent) · **文档:** [EN](docs/en/README.md) · [RU](docs/ru/README.md) · **赞助:** [Boosty](https://boosty.to/javded/single-payment/donation/805721/target?share=target_link)
## 功能
- **工具调用** — 文件、shell、网页、代码执行，可选的 Playwright 浏览器工具
- **持久化记忆** — SQLite 对话记录 + ChromaDB 语义搜索
- **技能** — Markdown 技能，支持自动生成与 hub 目录（ClawHub、Hermes、Claude 插件）
- **MCP** — 为每个 agent 配置和分配 Model Context Protocol 服务器
- **多提供商** — Ollama、LiteLLM、OpenAI、Groq 以及任何兼容 OpenAI 的 API
- **接口** — `holix tui`、`holix chat-command`、`holix run`、`holix gateway`
- **安全性** — API 密钥、速率限制、命令白名单、确认提示
- **运维** — `holix doctor`、`holix logs`、后台 gateway 守护进程、Docker
## 快速开始
### 安装
**单行安装**（自动检测操作系统语言，询问完整安装还是最小化安装，并运行 `holix bootstrap` 来配置 LLM + Telegram）：
```
curl -fsSL https://raw.githubusercontent.com/javded-itres/Holix/main/scripts/install.sh | bash
```
俄语系统会自动使用俄语提示；英语系统可选择 EN/RU。详见 [docs/en/INSTALLATION.md](docs/en/INSTALLATION.md)。
**从 PyPI 安装**（Python 3.12+）。包名：[`Holix`](https://pypi.org/project/Holix/)，CLI 命令：`holix`：
```
pipx install Holix # global CLI (recommended)
pipx install "Holix[all]" # + telegram, browser, tui-web, voice
# 或在 virtualenv 中：
pip install Holix
pip install "Holix[telegram,browser]"
```
请勿使用 `pip install helix` —— 那是 PyPI 上一个**不同**的包。
后续更新：`holix update --channel pypi`
**从源码安装（开发者）：**
```
git clone https://github.com/javded-itres/Holix.git
cd Holix
./scripts/install.sh # macOS / Linux
# Windows: .\scripts\install.ps1
holix version
holix doctor
```
发布指南：[docs/en/PYPI.md](docs/en/PYPI.md)
开发者安装：
```
uv sync && uv pip install -e .
cp .env.example .env
```
完整指南：[docs/en/INSTALLATION.md](docs/en/INSTALLATION.md)
### 配置并运行
```
holix models setup
holix tui # recommended UI
# 或：
holix chat-command
holix run "What is in this repo?"
holix gateway start
```
## 文档（英文）
| 主题 | 链接 |
|-------|------|
| 安装与更新 | [INSTALLATION.md](docs/en/INSTALLATION.md) |
| **CLI 参考** | [CLI.md](docs/en/CLI.md) |
| **斜杠命令 `/`** | [SLASH_COMMANDS.md](docs/en/SLASH_COMMANDS.md) |
| TUI | [TUI.md](docs/en/TUI.md) |
| 配置 | [CONFIGURATION.md](docs/en/CONFIGURATION.md) |
| Skill Hub | [HUB.md](docs/en/HUB.md) |
| API 网关 | [GATEWAY.md](docs/en/GATEWAY.md) |
| **MAX messenger** | [MAX.md](docs/en/MAX.md) |
| 日志 | [LOGS.md](docs/en/LOGS.md) |
| Doctor | [DOCTOR.md](docs/en/DOCTOR.md) |
| 安全性 | [SECURITY.md](docs/en/SECURITY.md) |
| 部署 | [DEPLOYMENT.md](docs/en/DEPLOYMENT.md) |
| 故障排除 | [TROUBLESHOOTING.md](docs/en/TROUBLESHOOTING.md) |
| 架构 | [ARCHITECTURE.md](docs/en/ARCHITECTURE.md) |
## Документация (русский)
| Тема | Ссылка |
|------|--------|
| Установка | [INSTALLATION.md](docs/ru/INSTALLATION.md) |
| CLI | [CLI.md](docs/ru/CLI.md) |
| Слэш-команды | [SLASH_COMMANDS.md](docs/ru/SLASH_COMMANDS.md) |
| Начало | [START_HERE.md](docs/ru/START_HERE.md) |
| **MAX** | [MAX.md](docs/ru/MAX.md) |
## CLI 速览
```
holix tui # main UI
holix run "query" # one-shot
holix models setup # providers
holix hub browse # external skills
holix mcp setup # MCP servers
holix gateway start|status|stop|reload
holix logs [-s agent] [-f]
holix doctor [--fix]
holix install | holix update
```
在 TUI/Telegram 中，输入 `/help` 查看斜杠命令。详见 [docs/en/SLASH_COMMANDS.md](docs/en/SLASH_COMMANDS.md)。
## 架构
```
HolixAgent → run_agent_loop() (core/agent_execution.py)
→ LangGraph / AgentLoop
```
| 层级 | 路径 |
|-------|------|
| 执行 | `core/agent_execution.py` |
| 事件 | `core/agent_events.py` |
| 工具 | `core/tools/` |
| 记忆 | `core/memory/` |
| CLI | `cli/main.py` |
| 网关 | `api/gateway.py` |
详情：[docs/en/ARCHITECTURE.md](docs/en/ARCHITECTURE.md)
## Docker
```
docker compose up -d
```
## 贡献
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。在提交 PR 之前运行测试：`uv run pytest -m "not llm"`。
## 许可证
MIT — 详见 [LICENSE](LICENSE)
标签：AI智能体, DLL 劫持, MCP, Python, 大语言模型, 工具调用, 持久化记忆, 无后门, 特征检测, 请求拦截, 逆向工具