Metadata-Version: 2.4
Name: HelixAgentAi
Version: 0.1.5
Summary: Self-improving AI agent with memory, skills, MCP, CLI, and TUI
Project-URL: Homepage, https://helix-agent.ru
Project-URL: Documentation, https://helix-agent.ru
Project-URL: Repository, https://github.com/javded-itres/HelixAgent
Project-URL: Issues, https://github.com/javded-itres/HelixAgent/issues
Project-URL: Changelog, https://github.com/javded-itres/HelixAgent/blob/master/docs/CHANGELOG.md
Author: Pavel Lukyanov
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,cli,langgraph,llm,mcp,tools
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.12
Requires-Dist: aiohttp>=3.9.0
Requires-Dist: aiosqlite>=0.19.0
Requires-Dist: chromadb>=0.4.0
Requires-Dist: croniter>=2.0.0
Requires-Dist: dishka>=1.10.1
Requires-Dist: fastapi>=0.136.3
Requires-Dist: langchain-core>=0.3.0
Requires-Dist: langgraph-checkpoint>=4.0.0
Requires-Dist: langgraph>=1.2.0
Requires-Dist: mcp>=1.2.0
Requires-Dist: openai>=1.30.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic>=2.0
Requires-Dist: python-dotenv>=1.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: textual>=0.80.0
Requires-Dist: tiktoken>=0.7.0
Requires-Dist: typer>=0.9.0
Requires-Dist: uvicorn>=0.48.0
Provides-Extra: all
Requires-Dist: aiogram>=3.15.0; extra == 'all'
Requires-Dist: faster-whisper>=1.1.0; extra == 'all'
Requires-Dist: playwright>=1.49.0; extra == 'all'
Requires-Dist: psutil>=6.0.0; extra == 'all'
Requires-Dist: pypdf>=4.0.0; extra == 'all'
Requires-Dist: textual-serve>=1.1.3; extra == 'all'
Provides-Extra: browser
Requires-Dist: playwright>=1.49.0; extra == 'browser'
Provides-Extra: telegram
Requires-Dist: aiogram>=3.15.0; extra == 'telegram'
Requires-Dist: pypdf>=4.0.0; extra == 'telegram'
Provides-Extra: tui-web
Requires-Dist: textual-serve>=1.1.3; extra == 'tui-web'
Provides-Extra: voice
Requires-Dist: faster-whisper>=1.1.0; extra == 'voice'
Provides-Extra: windows
Requires-Dist: psutil>=6.0.0; extra == 'windows'
Description-Content-Type: text/markdown

# 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.

[![PyPI](https://img.shields.io/pypi/v/HelixAgentAi.svg)](https://pypi.org/project/HelixAgentAi/)
[![Python](https://img.shields.io/badge/python-3.12%2B-blue.svg)](https://python.org)
[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
[![Docs](https://img.shields.io/badge/docs-en%20%7C%20ru-blue)](docs/README.md)

**Website:** [helix-agent.ru](https://helix-agent.ru) · **PyPI:** [HelixAgentAi](https://pypi.org/project/HelixAgentAi/) · **GitHub:** [javded-itres/HelixAgent](https://github.com/javded-itres/HelixAgent) · **Docs:** [EN](docs/en/README.md) · [RU](docs/ru/README.md) · **Donate:** [support](https://messenger.online.sberbank.ru/sl/uwKJ687QKl7d1a1Ui)

---

## 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`](https://pypi.org/project/HelixAgentAi/), CLI command: `helix`:

```bash
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):**

```bash
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](docs/en/PYPI.md)

Developer install:

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

Full guide: [docs/en/INSTALLATION.md](docs/en/INSTALLATION.md)

### Configure and run

```bash
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](docs/en/INSTALLATION.md) |
| **CLI reference** | [CLI.md](docs/en/CLI.md) |
| **Slash commands `/`** | [SLASH_COMMANDS.md](docs/en/SLASH_COMMANDS.md) |
| TUI | [TUI.md](docs/en/TUI.md) |
| Configuration | [CONFIGURATION.md](docs/en/CONFIGURATION.md) |
| Skill Hub | [HUB.md](docs/en/HUB.md) |
| API Gateway | [GATEWAY.md](docs/en/GATEWAY.md) |
| Logs | [LOGS.md](docs/en/LOGS.md) |
| Doctor | [DOCTOR.md](docs/en/DOCTOR.md) |
| Security | [SECURITY.md](docs/en/SECURITY.md) |
| Deployment | [DEPLOYMENT.md](docs/en/DEPLOYMENT.md) |
| Troubleshooting | [TROUBLESHOOTING.md](docs/en/TROUBLESHOOTING.md) |
| Architecture | [ARCHITECTURE.md](docs/en/ARCHITECTURE.md) |

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

| Тема | Ссылка |
|------|--------|
| Установка | [INSTALLATION.md](docs/ru/INSTALLATION.md) |
| CLI | [CLI.md](docs/ru/CLI.md) |
| Слэш-команды | [SLASH_COMMANDS.md](docs/ru/SLASH_COMMANDS.md) |
| Начало | [START_HERE.md](docs/ru/START_HERE.md) |

---

## CLI at a glance

```bash
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](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](docs/en/ARCHITECTURE.md)

---

## Docker

```bash
docker compose up -d
```

---

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md). Run tests before PRs: `uv run pytest -m "not llm"`.

---

## License

MIT — see [LICENSE](LICENSE)