HelixAgentAi 0.1.5

Self-improving AI agent with memory, skills, MCP, CLI, and TUI

Helix — Self-Improving AI Agent

Helix 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: helix-agent.ru · PyPI: HelixAgentAi · GitHub: javded-itres/HelixAgent · Docs: EN · RU · Donate: support

---

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 — helix tui, helix chat-command, helix run, helix gateway
• Security — API keys, rate limits, command whitelist, confirmation prompts
• Operations — helix doctor, helix logs, background gateway supervisor, Docker

---

Quick start

Install

Install from PyPI (Python 3.12+). Package: HelixAgentAi, CLI command: helix:

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

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

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

Update later: helix update --channel pypi

From source (developers):

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

helix version
helix doctor

Publishing: docs/en/PYPI.md

Developer install:

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

Full guide: docs/en/INSTALLATION.md

Configure and run

helix models setup
helix tui                    # recommended UI
# or:
helix chat-command
helix run "What is in this repo?"
helix 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
Logs	LOGS.md
Doctor	DOCTOR.md
Security	SECURITY.md
Deployment	DEPLOYMENT.md
Troubleshooting	TROUBLESHOOTING.md
Architecture	ARCHITECTURE.md

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

Тема	Ссылка
Установка	INSTALLATION.md
CLI	CLI.md
Слэш-команды	SLASH_COMMANDS.md
Начало	START_HERE.md

---

CLI at a glance

helix tui                          # main UI
helix run "query"                  # one-shot
helix models setup                 # providers
helix hub browse                   # external skills
helix mcp setup                    # MCP servers
helix gateway start|status|stop|reload
helix logs [-s agent] [-f]
helix doctor [--fix]
helix install | helix update

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

---

Architecture

HelixAgent → 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

docker compose up -d

---

Contributing

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

---

License

MIT — see LICENSE