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
Metadata
1 maintainer
Release files for Holix 1.1.20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| holix-1.1.20.tar.gz | 1.4 MB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| holix-1.1.20-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 3.3 MB
Release files / holix-1.1.20.tar.gz
| Download URL | holix-1.1.20.tar.gz |
|---|---|
| Size | 1.4 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
1eda6597954fe5a40268553c1d82eaf046fafb97c83fb545fbed3bd2ce73fd07
|
|
BLAKE2b-256 checksum How to use checksums |
6b36c760f5207f1a8c4c25090ba2d56d2c91089a3f138886d5d2dd7f403cce9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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.20-py3-none-any.whl
| Download URL | holix-1.1.20-py3-none-any.whl |
|---|---|
| Size | 1.8 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
965ce8d1765f581ed5d044873b622a42f4a017d29cbb9d2e23abe54e419c2ada
|
|
BLAKE2b-256 checksum How to use checksums |
1f6b55a4f3244fc6fd0f6b33134c4f18d2c47253fe64a34db709def7c9e3681f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","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}
|
Security for Holix 1.1.20
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
