Holix 开源自我改进 AI 智能体发布，支持持久记忆与 MCP

Self-improving AI agent — persistent memory, skills, MCP, CLI/TUI, Telegram and MAX.
MIT core. Run it in the terminal, or open it in Studio.

Open-source ядро агента: память, навыки, MCP, терминал, Telegram и MAX.
Дальше — локальная IDE или облачная Studio для команд.

Docs holix-agent.ru · PyPI · Telegram @helix_agent · Docs EN · Docs RU · Donate

Features

Tool calling — files, shell, web, code execution, optional Playwright browser tools
Persistent memory — SQLite conversations + ChromaDB semantic search
Skills — markdown skills with auto-generation and hub catalogs (ClawHub, Hermes, Claude plugins)
MCP — configure and assign Model Context Protocol servers per agent
Multi-provider — Ollama, LiteLLM, OpenAI, Groq, and any OpenAI-compatible API
Interfaces — holix tui, holix chat-command, holix run, holix gateway
Studio CE — single-user local IDE (holix-studio-ce); teams use holix-studio.ru
Security — API keys, rate limits, command whitelist, confirmation prompts
Operations — holix doctor, holix logs, background gateway supervisor, Docker

Quick start

Install

One-line install (detects OS language, asks full vs minimal, runs holix bootstrap for LLM + Telegram):

curl -fsSL https://raw.githubusercontent.com/javded-itres/Holix/main/scripts/install.sh | bash

Russian systems use Russian prompts automatically; English systems choose EN/RU. See docs/en/INSTALLATION.md.

Install from PyPI (Python 3.12+). Package: Holix, CLI command: holix:

pipx install Holix              # global CLI (recommended)
pipx install "Holix[all]"       # + telegram, browser, tui-web, voice

# or in a virtualenv:
pip install Holix
pip install "Holix[telegram,browser]"

Do not use pip install helix — that is a different package on PyPI.

Update later: holix update --channel pypi

From source (developers):

git clone https://github.com/javded-itres/Holix.git
cd Holix
./scripts/install.sh          # macOS / Linux
# Windows: .\scripts\install.ps1

holix version
holix doctor

Publishing: docs/en/PYPI.md

Developer install:

uv sync && uv pip install -e .
cp .env.example .env

Full guide: docs/en/INSTALLATION.md

Local IDE (Studio CE)

Browser IDE for one user on your machine: chat, files, git, terminal.

Repo: github.com/javded-itres/holix-studio-ce Setup: EN · RU

curl -fsSL https://raw.githubusercontent.com/javded-itres/holix-studio-ce/main/scripts/install.sh | bash
holix-studio-ce serve
# http://127.0.0.1:8788/studio/

Cloud for teams: holix-studio.ru

Configure and run

holix models setup
holix tui                    # recommended UI
# or:
holix chat-command
holix run "What is in this repo?"
holix gateway start

Documentation (English)

Topic	Link
Install & update	INSTALLATION.md
CLI reference	CLI.md
Slash commands `/`	SLASH_COMMANDS.md
TUI	TUI.md
Configuration	CONFIGURATION.md
Skill Hub	HUB.md
API Gateway	GATEWAY.md
MAX messenger	MAX.md
Logs	LOGS.md
Doctor	DOCTOR.md
Security	SECURITY.md
Deployment	DEPLOYMENT.md
Troubleshooting	TROUBLESHOOTING.md
Architecture	ARCHITECTURE.md
Studio CE (local IDE)	holix-studio-ce

Документация (русский)

Тема	Ссылка
Установка	INSTALLATION.md
CLI	CLI.md
Слэш-команды	SLASH_COMMANDS.md
Начало	START_HERE.md
MAX	MAX.md
Studio CE (локальная IDE)	holix-studio-ce

CLI at a glance

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

In TUI/Telegram, type /help for slash commands. See docs/en/SLASH_COMMANDS.md.

Architecture

HolixAgent → run_agent_loop() (core/agent_execution.py)
           → LangGraph / AgentLoop

Layer	Path
Execution	`core/agent_execution.py`
Events	`core/agent_events.py`
Tools	`core/tools/`
Memory	`core/memory/`
CLI	`cli/main.py`
Gateway	`api/gateway.py`

Details: docs/en/ARCHITECTURE.md

Docker

cp docker/env.example .env
# set TELEGRAM_BOT_TOKEN, MODEL, BASE_URL, API_KEY, HOLIX_API_KEY_PEPPER
docker compose up -d --build

Mode	Command
Full agent (gateway + Telegram)	`docker compose up -d`
+ local Ollama	`docker compose --profile ollama up -d`
Gateway API only	`docker compose --profile gateway-only up -d holix-gateway`
Multi-user prod (bind mounts)	`docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d`

Drop-in extensions: put packages under ./extensions/. Full guide: docs/en/INSTALLATION.md § Path B.

Contributing

See CONTRIBUTING.md. Run tests before PRs: uv run pytest -m "not llm".

Extensions

Build extensions with the separate holix-sdk package (stable public API):

pip install holix-sdk Holix

Repository: github.com/javded-itres/holix-sdk

Guide	Path
English	holix-sdk/docs/en/EXTENSIONS.md
Russian	holix-sdk/docs/ru/EXTENSIONS.md
Holix copy (EN)	docs/en/EXTENSIONS.md

holix extensions list
holix extensions agent-list

Reference: packages/holix-extension-demo in this repo.

License

Holix core: MIT — see LICENSE.

Holix Studio CE (single-user local IDE): javded-itres/holix-studio-ce — public landing and installer. Not a dump of Cloud source.

Holix Studio Cloud (teams, billing, instance license): holix-studio.ru, source-available product (no redistribution or resale of the Cloud IDE). Holix loads Studio via the holix.extensions entry-point API — see THIRD_PARTY_LICENSES.md.