Holix — Self-Improving AI Agent
Holix is a self-improving AI agent with persistent memory, a skills system, tool calling, MCP integration, and multiple interfaces: CLI, TUI, API gateway, and Telegram.
Website: holix-agent.ru · PyPI: Holix · GitHub: javded-itres/Holix · Studio CE: holix-studio-ce · Telegram: @helix_agent · Docs: EN · RU · Donate: Boosty
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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file holix-1.1.2.tar.gz.
File metadata
- Download URL: holix-1.1.2.tar.gz
- Upload date:
- Size: 1.2 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9a53f0819b040a7f0b85a39baca633824ad9d0a75b1f1b09b134035ef296f0ab
|
|
| MD5 |
2c958f56d514c8578360bfc0ece5a5bb
|
|
| BLAKE2b-256 |
66c5930cf61c07db63ac2fdfaecda4395d630dc10c2e2675b88900a97aa127f0
|
File details
Details for the file holix-1.1.2-py3-none-any.whl.
File metadata
- Download URL: holix-1.1.2-py3-none-any.whl
- Upload date:
- Size: 1.6 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
41efdfced430da2888281d05be7691e60eb19f8877a3f7d9649094300ceefc64
|
|
| MD5 |
380c32d96b40bfd89bfd80402e656b29
|
|
| BLAKE2b-256 |
49338df3a6729b809c37c91cf7fe9f377174a82021b1fcfe93873ac03d4f27f8
|
