Holix Agent
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 для команд.
Holix Studio CE →
Одноместный Workspace на вашей машине: полноценный функционал Holix Studio локально. |
Сайт Holix Studio →
Веб-среда для команд: агент, код, preview, Docker, роли и процессы |
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.
1 maintainer
Release files for Holix 1.1.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| holix-1.1.12.tar.gz | 1.3 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| holix-1.1.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.0 MB
Release files / holix-1.1.12.tar.gz
| Download URL | holix-1.1.12.tar.gz |
|---|---|
| Size | 1.3 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
06fe10494a8043c51a3349e00927084b7e55d9f5bdc5d4080fe93f4f6eb5ca9e
|
|
BLAKE2b-256 checksum How to use checksums |
3d74daf959e3a099d6017cb953126507ec0e3bc27c8ee8f50d34adde1ed3b665
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / holix-1.1.12-py3-none-any.whl
| Download URL | holix-1.1.12-py3-none-any.whl |
|---|---|
| Size | 1.7 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
04d3e481aeb04c2155e75e8ac46a28a1ed26a0d650505bceae7ba46ac2d01b6e
|
|
BLAKE2b-256 checksum How to use checksums |
513017d073d73a8d68ca96992e4f839dc4a19437c487458771b385424fe39e15
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
