elidia-agent-cli 2.0.0__tar.gz → 2.0.2__tar.gz

elidia_agent_cli-2.0.2/PKG-INFO

@@ -0,0 +1,374 @@
+Metadata-Version: 2.4
+Name: elidia-agent-cli
+Version: 2.0.2
+Summary: Multi-platform AI agent for the terminal and messaging apps — part of the AiUtils.io ecosystem, powered by Elidia Technology
+Author: AiUtils
+License-Expression: MIT
+Project-URL: Homepage, https://aiutils.io
+Project-URL: Documentation, https://aiutils.io/elidia
+Project-URL: Repository, https://github.com/Elidia-Technology/elidia-agent-cli-v2
+Project-URL: Bug Tracker, https://github.com/Elidia-Technology/elidia-agent-cli-v2/issues
+Project-URL: Discord, https://discord.gg/AiUtils
+Requires-Python: <3.14,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: openai==2.24.0
+Requires-Dist: python-dotenv==1.2.2
+Requires-Dist: fire==0.7.1
+Requires-Dist: httpx[socks]==0.28.1
+Requires-Dist: rich==14.3.3
+Requires-Dist: tenacity==9.1.4
+Requires-Dist: pyyaml==6.0.3
+Requires-Dist: ruamel.yaml==0.18.17
+Requires-Dist: requests==2.33.0
+Requires-Dist: jinja2==3.1.6
+Requires-Dist: pydantic==2.13.4
+Requires-Dist: prompt_toolkit==3.0.52
+Requires-Dist: croniter==6.0.0
+Requires-Dist: PyJWT[crypto]==2.12.1
+Requires-Dist: tzdata==2025.3; sys_platform == "win32"
+Requires-Dist: psutil==7.2.2
+Requires-Dist: pathspec==1.1.1
+Requires-Dist: fastapi<1,>=0.104.0
+Requires-Dist: uvicorn[standard]<1,>=0.24.0
+Requires-Dist: ptyprocess<1,>=0.7.0; sys_platform != "win32"
+Requires-Dist: pywinpty<3,>=2.0.0; sys_platform == "win32"
+Provides-Extra: anthropic
+Requires-Dist: anthropic==0.86.0; extra == "anthropic"
+Provides-Extra: exa
+Requires-Dist: exa-py==2.10.2; extra == "exa"
+Provides-Extra: firecrawl
+Requires-Dist: firecrawl-py==4.17.0; extra == "firecrawl"
+Provides-Extra: parallel-web
+Requires-Dist: parallel-web==0.4.2; extra == "parallel-web"
+Provides-Extra: fal
+Requires-Dist: fal-client==0.13.1; extra == "fal"
+Provides-Extra: edge-tts
+Requires-Dist: edge-tts==7.2.7; extra == "edge-tts"
+Provides-Extra: modal
+Requires-Dist: modal==1.3.4; extra == "modal"
+Provides-Extra: daytona
+Requires-Dist: daytona==0.155.0; extra == "daytona"
+Provides-Extra: hindsight
+Requires-Dist: hindsight-client==0.6.1; extra == "hindsight"
+Provides-Extra: dev
+Requires-Dist: debugpy==1.8.20; extra == "dev"
+Requires-Dist: pytest==9.0.2; extra == "dev"
+Requires-Dist: pytest-asyncio==1.3.0; extra == "dev"
+Requires-Dist: pytest-timeout==2.4.0; extra == "dev"
+Requires-Dist: mcp==1.26.0; extra == "dev"
+Requires-Dist: starlette==1.0.1; extra == "dev"
+Requires-Dist: ty==0.0.21; extra == "dev"
+Requires-Dist: ruff==0.15.10; extra == "dev"
+Requires-Dist: setuptools==82.0.1; extra == "dev"
+Provides-Extra: messaging
+Requires-Dist: python-telegram-bot[webhooks]==22.6; extra == "messaging"
+Requires-Dist: discord.py[voice]==2.7.1; extra == "messaging"
+Requires-Dist: aiohttp==3.13.3; extra == "messaging"
+Requires-Dist: brotlicffi==1.2.0.1; extra == "messaging"
+Requires-Dist: slack-bolt==1.27.0; extra == "messaging"
+Requires-Dist: slack-sdk==3.40.1; extra == "messaging"
+Requires-Dist: qrcode==7.4.2; extra == "messaging"
+Provides-Extra: cron
+Provides-Extra: slack
+Requires-Dist: slack-bolt==1.27.0; extra == "slack"
+Requires-Dist: slack-sdk==3.40.1; extra == "slack"
+Requires-Dist: aiohttp==3.13.3; extra == "slack"
+Provides-Extra: matrix
+Requires-Dist: mautrix[encryption]==0.21.0; extra == "matrix"
+Requires-Dist: Markdown==3.10.2; extra == "matrix"
+Requires-Dist: aiosqlite==0.22.1; extra == "matrix"
+Requires-Dist: asyncpg==0.31.0; extra == "matrix"
+Requires-Dist: aiohttp-socks==0.11.0; extra == "matrix"
+Provides-Extra: wecom
+Requires-Dist: defusedxml==0.7.1; extra == "wecom"
+Provides-Extra: cli
+Requires-Dist: simple-term-menu==1.6.6; extra == "cli"
+Provides-Extra: tts-premium
+Requires-Dist: elevenlabs==1.59.0; extra == "tts-premium"
+Provides-Extra: voice
+Requires-Dist: faster-whisper==1.2.1; extra == "voice"
+Requires-Dist: sounddevice==0.5.5; extra == "voice"
+Requires-Dist: numpy==2.4.3; extra == "voice"
+Provides-Extra: pty
+Provides-Extra: honcho
+Requires-Dist: honcho-ai==2.0.1; extra == "honcho"
+Provides-Extra: mcp
+Requires-Dist: mcp==1.26.0; extra == "mcp"
+Requires-Dist: starlette==1.0.1; extra == "mcp"
+Provides-Extra: nemo-relay
+Requires-Dist: nemo-relay==0.3; extra == "nemo-relay"
+Provides-Extra: homeassistant
+Requires-Dist: aiohttp==3.13.3; extra == "homeassistant"
+Provides-Extra: sms
+Requires-Dist: aiohttp==3.13.3; extra == "sms"
+Provides-Extra: computer-use
+Requires-Dist: mcp==1.26.0; extra == "computer-use"
+Requires-Dist: starlette==1.0.1; extra == "computer-use"
+Provides-Extra: acp
+Requires-Dist: agent-client-protocol==0.9.0; extra == "acp"
+Provides-Extra: mistral
+Requires-Dist: mistralai==2.4.8; extra == "mistral"
+Provides-Extra: bedrock
+Requires-Dist: boto3==1.42.89; extra == "bedrock"
+Provides-Extra: azure-identity
+Requires-Dist: azure-identity==1.25.3; extra == "azure-identity"
+Provides-Extra: termux
+Requires-Dist: python-telegram-bot[webhooks]==22.6; extra == "termux"
+Requires-Dist: elidia-agent-cli[cron]; extra == "termux"
+Requires-Dist: elidia-agent-cli[cli]; extra == "termux"
+Requires-Dist: elidia-agent-cli[pty]; extra == "termux"
+Requires-Dist: elidia-agent-cli[mcp]; extra == "termux"
+Requires-Dist: elidia-agent-cli[honcho]; extra == "termux"
+Requires-Dist: elidia-agent-cli[acp]; extra == "termux"
+Provides-Extra: termux-all
+Requires-Dist: elidia-agent-cli[termux]; extra == "termux-all"
+Requires-Dist: elidia-agent-cli[google]; extra == "termux-all"
+Requires-Dist: elidia-agent-cli[homeassistant]; extra == "termux-all"
+Requires-Dist: elidia-agent-cli[sms]; extra == "termux-all"
+Requires-Dist: elidia-agent-cli[web]; extra == "termux-all"
+Provides-Extra: dingtalk
+Requires-Dist: dingtalk-stream==0.24.3; extra == "dingtalk"
+Requires-Dist: alibabacloud-dingtalk==2.2.42; extra == "dingtalk"
+Requires-Dist: qrcode==7.4.2; extra == "dingtalk"
+Provides-Extra: feishu
+Requires-Dist: lark-oapi==1.5.3; extra == "feishu"
+Requires-Dist: qrcode==7.4.2; extra == "feishu"
+Provides-Extra: google
+Requires-Dist: google-api-python-client==2.194.0; extra == "google"
+Requires-Dist: google-auth-oauthlib==1.3.1; extra == "google"
+Requires-Dist: google-auth-httplib2==0.3.1; extra == "google"
+Provides-Extra: youtube
+Requires-Dist: youtube-transcript-api==1.2.4; extra == "youtube"
+Provides-Extra: web
+Requires-Dist: fastapi==0.133.1; extra == "web"
+Requires-Dist: uvicorn[standard]==0.41.0; extra == "web"
+Requires-Dist: starlette==1.0.1; extra == "web"
+Provides-Extra: all
+Requires-Dist: elidia-agent-cli[cron]; extra == "all"
+Requires-Dist: elidia-agent-cli[cli]; extra == "all"
+Requires-Dist: elidia-agent-cli[dev]; extra == "all"
+Requires-Dist: elidia-agent-cli[pty]; extra == "all"
+Requires-Dist: elidia-agent-cli[mcp]; extra == "all"
+Requires-Dist: elidia-agent-cli[homeassistant]; extra == "all"
+Requires-Dist: elidia-agent-cli[sms]; extra == "all"
+Requires-Dist: elidia-agent-cli[acp]; extra == "all"
+Requires-Dist: elidia-agent-cli[google]; extra == "all"
+Requires-Dist: elidia-agent-cli[web]; extra == "all"
+Requires-Dist: elidia-agent-cli[youtube]; extra == "all"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/banner.png" alt="Elidia Agent" width="100%">
+</p>
+
+# Elidia Agent
+
+<p align="center">
+  <a href="https://pypi.org/project/elidia-agent-cli/"><img src="https://img.shields.io/pypi/v/elidia-agent-cli?style=for-the-badge&label=PyPI&color=3775A9" alt="PyPI"></a>
+  <a href="https://aiutils.io/elidia"><img src="https://img.shields.io/badge/Docs-aiutils.io-FFD700?style=for-the-badge" alt="Documentation"></a>
+  <a href="https://developer.aiutils.io"><img src="https://img.shields.io/badge/Developer%20Console-developer.aiutils.io-3775A9?style=for-the-badge" alt="Developer Console"></a>
+  <a href="https://aiutils.io"><img src="https://img.shields.io/badge/Powered%20by-Elidia%20Technology-blueviolet?style=for-the-badge" alt="Powered by Elidia Technology"></a>
+  <a href="README.in.md"><img src="https://img.shields.io/badge/Lang-Hindi-orange?style=for-the-badge" alt="हिन्दी"></a>
+</p>
+
+**Elidia Agent** is a multi-platform AI agent for your terminal and messaging apps. It is part of the [AiUtils.io](https://aiutils.io) ecosystem and powered by **Elidia Technology Pvt. Ltd.**
+
+Use it with the model provider you already work with — [Elidia Portal](https://developer.aiutils.io), [OpenRouter](https://openrouter.ai) (200+ models), [NovitaAI](https://novita.ai), [NVIDIA NIM](https://build.nvidia.com), [Xiaomi MiMo](https://platform.xiaomimimo.com), [z.ai/GLM](https://z.ai), [Kimi/Moonshot](https://platform.moonshot.ai), [MiniMax](https://www.minimax.io), [Hugging Face](https://huggingface.co), OpenAI, or your own endpoint. Switch with `elidia model` — no code changes, no lock-in.
+
+## ✨ Features
+
+| | |
+| --- | --- |
+| 🖥️ **Terminal interface** | Interactive TUI with multiline editing, slash-command autocomplete, conversation history, and streaming tool output. |
+| 📱 **Messaging platforms** | Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway. |
+| 🧠 **Memory & skills** | Remembers across sessions, creates reusable skills, and works with the [agentskills.io](https://agentskills.io) open standard. |
+| ⏰ **Scheduled tasks** | Built-in cron for daily reports, backups, and audits — described in plain language. |
+| 🧩 **Subagents** | Spawn isolated subagents to handle work in parallel. |
+| ☁️ **Flexible deployment** | Run locally, in Docker, over SSH, or on serverless backends (Modal, Daytona). |
+| 🔬 **Research tooling** | Batch trajectory generation and compression for training tool-calling models. |
+
+---
+
+## 🚀 Install
+
+Requires **Python 3.11–3.13**.
+
+```bash
+pip install elidia-agent-cli
+```
+
+Prefer an isolated tool environment? Use [uv](https://docs.astral.sh/uv/) (recommended) or [pipx](https://pipx.pypa.io/):
+
+```bash
+uv tool install elidia-agent-cli
+# or
+pipx install elidia-agent-cli
+```
+
+To include every optional backend in one go (messaging platforms, web search, image generation, TTS, and more):
+
+```bash
+pip install "elidia-agent-cli[all]"
+```
+
+Then start:
+
+```bash
+elidia              # start chatting
+```
+
+> [!NOTE]
+> **Android / Termux:** see the [Termux guide](docs/termux.md). On Termux, install the curated extra that skips Android-incompatible voice dependencies:
+>
+> ```bash
+> pip install "elidia-agent-cli[termux]"
+> ```
+
+Full installation details: [docs/installation.md](docs/installation.md).
+
+---
+
+## 🏁 Getting Started
+
+```bash
+elidia              # Interactive CLI — start a conversation
+elidia model        # Choose your LLM provider and model
+elidia tools        # Configure which tools are enabled
+elidia config set   # Set individual config values
+elidia gateway      # Start the messaging gateway (Telegram, Discord, etc.)
+elidia setup        # Run the full setup wizard
+elidia claw migrate # Migrate from OpenClaw
+elidia update       # Update to the latest version
+elidia doctor       # Diagnose any issues
+```
+
+📖 **[Full documentation →](https://aiutils.io/elidia)** — or browse the in-repo guides below.
+
+---
+
+## 🎁 One subscription for everything — Elidia Portal
+
+Elidia works with any provider. If you'd rather not manage separate API keys for the model, web search, image generation, TTS, and a cloud browser, **[Elidia Portal](https://developer.aiutils.io)** covers them under one subscription:
+
+- **300+ models** — pick any with `/model <name>`
+- **Tool Gateway** — web search (Firecrawl), image generation (FAL), text-to-speech (OpenAI), cloud browser (Browser Use), all routed through your subscription.
+
+One command from a fresh install:
+
+```bash
+elidia setup --portal
+```
+
+That signs you in via OAuth, sets Elidia as your provider, and switches on the Tool Gateway. Check what's connected at any time with `elidia portal info`. Full details: [docs/elidia-portal.md](docs/elidia-portal.md) and [docs/tool-gateway.md](docs/tool-gateway.md).
+
+You can still bring your own keys per-tool whenever you like — the gateway is per-backend, not all-or-nothing.
+
+---
+
+## 🧭 CLI vs Messaging — Quick Reference
+
+Elidia has two entry points: start the terminal UI with `elidia`, or run the gateway and talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or Email. Many slash commands work the same in both.
+
+| Action                         | CLI                                           | Messaging platforms                                                              |
+| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
+| Start chatting                 | `elidia`                                      | Run `elidia gateway setup` + `elidia gateway start`, then send the bot a message |
+| Start fresh conversation       | `/new` or `/reset`                            | `/new` or `/reset`                                                               |
+| Change model                   | `/model [provider:model]`                     | `/model [provider:model]`                                                        |
+| Set a personality              | `/personality [name]`                         | `/personality [name]`                                                            |
+| Retry or undo the last turn    | `/retry`, `/undo`                             | `/retry`, `/undo`                                                                |
+| Compress context / check usage | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]`                                        |
+| Browse skills                  | `/skills` or `/<skill-name>`                  | `/<skill-name>`                                                                  |
+| Interrupt current work         | `Ctrl+C` or send a new message                | `/stop` or send a new message                                                    |
+| Platform-specific status       | `/platforms`                                  | `/status`, `/sethome`                                                            |
+
+For the full command lists, see the [CLI guide](docs/cli.md) and the [Messaging Gateway guide](docs/messaging.md).
+
+---
+
+## 📚 Documentation
+
+All documentation lives at **[aiutils.io/elidia](https://aiutils.io/elidia)** and as Markdown files in this repository's [`docs/`](docs/README.md) folder:
+
+| Section                                                                    | What's Covered                                             |
+| -------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [Installation](docs/installation.md)                                       | Linux, macOS, WSL2, Windows, Termux                        |
+| [Quickstart](docs/quickstart.md)                                           | Install → setup → first conversation in 2 minutes          |
+| [CLI Usage](docs/cli.md)                                                   | Commands, keybindings, personalities, sessions             |
+| [Configuration](docs/configuration.md)                                     | Config file, providers, models, all options                |
+| [Messaging Gateway](docs/messaging.md)                                     | Telegram, Discord, Slack, WhatsApp, Signal, and more       |
+| [Security](docs/security.md)                                               | Command approval, DM pairing, container isolation          |
+| [Tools & Toolsets](docs/tools.md)                                          | 40+ tools, toolset system, terminal backends               |
+| [Skills System](docs/skills.md)                                            | Procedural memory, Skills Hub, creating skills             |
+| [Memory](docs/memory.md)                                                   | Persistent memory, user profiles, best practices           |
+| [MCP Integration](docs/mcp.md)                                             | Connect any MCP server for extended capabilities           |
+| [Cron Scheduling](docs/cron.md)                                            | Scheduled tasks with platform delivery                     |
+| [Context Files](docs/context-files.md)                                     | Project context that shapes every conversation             |
+| [Elidia Portal](docs/elidia-portal.md)                                     | One subscription, 300+ models, Tool Gateway                |
+| [Migrating from OpenClaw](docs/migrate-from-openclaw.md)                   | Import settings, memories, skills, and API keys            |
+| [Architecture](docs/architecture.md)                                       | Project structure, agent loop, key classes                 |
+| [Contributing](docs/contributing.md)                                       | Development setup, PR process, code style                  |
+| [CLI Reference](docs/cli-commands.md)                                      | All commands and flags                                     |
+| [Environment Variables](docs/environment-variables.md)                     | Complete env var reference                                 |
+
+---
+
+## 🔄 Migrating from OpenClaw
+
+If you're coming from OpenClaw, Elidia can import your settings, memories, skills, and API keys.
+
+**During first-time setup:** the setup wizard (`elidia setup`) detects `~/.openclaw` and offers to migrate before configuration begins.
+
+**Anytime after install:**
+
+```bash
+elidia claw migrate              # Interactive migration (full preset)
+elidia claw migrate --dry-run    # Preview what would be migrated
+elidia claw migrate --preset user-data   # Migrate without secrets
+elidia claw migrate --overwrite  # Overwrite existing conflicts
+```
+
+What gets imported:
+
+- **SOUL.md** — persona file
+- **Memories** — MEMORY.md and USER.md entries
+- **Skills** — user-created skills → `~/.elidia/skills/openclaw-imports/`
+- **Command allowlist** — approval patterns
+- **Messaging settings** — platform configs, allowed users, working directory
+- **API keys** — allowlisted secrets (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
+- **TTS assets** — workspace audio files
+- **Workspace instructions** — AGENTS.md (with `--workspace-target`)
+
+See [docs/migrate-from-openclaw.md](docs/migrate-from-openclaw.md) for the complete guide.
+
+---
+
+## 📦 Repository & Releases
+
+This public repository hosts the **packaged releases and documentation** for Elidia Agent. The source code is developed in a private repository and distributed as build artefacts on [PyPI](https://pypi.org/project/elidia-agent-cli/).
+
+- **Latest release:** see the [Releases](https://github.com/Elidia-Technology/elidia-agent-cli-v2/releases) page for the current `.whl` and `.tar.gz` build artefacts.
+- **Documentation:** [aiutils.io/elidia](https://aiutils.io/elidia)
+- **Developer console:** [developer.aiutils.io](https://developer.aiutils.io)
+- **Report a bug / request a feature:** open an [Issue](https://github.com/Elidia-Technology/elidia-agent-cli-v2/issues)
+
+Contributions are welcome — see the [Contributing Guide](docs/contributing.md) for code style and the PR process. Since this repository does not host source code, please raise issues here rather than opening code PRs against it.
+
+---
+
+## 🤝 Community
+
+- 💬 [Discord](https://discord.gg/AiUtils)
+- 📚 [Skills Hub](https://agentskills.io)
+- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server for Elidia and other MCP hosts.
+- 🔌 [ElidiaClaw](https://github.com/AaronWong1999/elidiaclaw) — community WeChat bridge: run Elidia Agent and OpenClaw on the same WeChat account.
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built with ❤️ by [Elidia Technology Pvt. Ltd.](https://aiutils.io) — part of the [AiUtils.io](https://aiutils.io) ecosystem.

elidia_agent_cli-2.0.2/README.md

@@ -0,0 +1,214 @@
+<p align="center">
+  <img src="assets/banner.png" alt="Elidia Agent" width="100%">
+</p>
+
+# Elidia Agent
+
+<p align="center">
+  <a href="https://pypi.org/project/elidia-agent-cli/"><img src="https://img.shields.io/pypi/v/elidia-agent-cli?style=for-the-badge&label=PyPI&color=3775A9" alt="PyPI"></a>
+  <a href="https://aiutils.io/elidia"><img src="https://img.shields.io/badge/Docs-aiutils.io-FFD700?style=for-the-badge" alt="Documentation"></a>
+  <a href="https://developer.aiutils.io"><img src="https://img.shields.io/badge/Developer%20Console-developer.aiutils.io-3775A9?style=for-the-badge" alt="Developer Console"></a>
+  <a href="https://aiutils.io"><img src="https://img.shields.io/badge/Powered%20by-Elidia%20Technology-blueviolet?style=for-the-badge" alt="Powered by Elidia Technology"></a>
+  <a href="README.in.md"><img src="https://img.shields.io/badge/Lang-Hindi-orange?style=for-the-badge" alt="हिन्दी"></a>
+</p>
+
+**Elidia Agent** is a multi-platform AI agent for your terminal and messaging apps. It is part of the [AiUtils.io](https://aiutils.io) ecosystem and powered by **Elidia Technology Pvt. Ltd.**
+
+Use it with the model provider you already work with — [Elidia Portal](https://developer.aiutils.io), [OpenRouter](https://openrouter.ai) (200+ models), [NovitaAI](https://novita.ai), [NVIDIA NIM](https://build.nvidia.com), [Xiaomi MiMo](https://platform.xiaomimimo.com), [z.ai/GLM](https://z.ai), [Kimi/Moonshot](https://platform.moonshot.ai), [MiniMax](https://www.minimax.io), [Hugging Face](https://huggingface.co), OpenAI, or your own endpoint. Switch with `elidia model` — no code changes, no lock-in.
+
+## ✨ Features
+
+| | |
+| --- | --- |
+| 🖥️ **Terminal interface** | Interactive TUI with multiline editing, slash-command autocomplete, conversation history, and streaming tool output. |
+| 📱 **Messaging platforms** | Telegram, Discord, Slack, WhatsApp, Signal, and CLI — all from a single gateway. |
+| 🧠 **Memory & skills** | Remembers across sessions, creates reusable skills, and works with the [agentskills.io](https://agentskills.io) open standard. |
+| ⏰ **Scheduled tasks** | Built-in cron for daily reports, backups, and audits — described in plain language. |
+| 🧩 **Subagents** | Spawn isolated subagents to handle work in parallel. |
+| ☁️ **Flexible deployment** | Run locally, in Docker, over SSH, or on serverless backends (Modal, Daytona). |
+| 🔬 **Research tooling** | Batch trajectory generation and compression for training tool-calling models. |
+
+---
+
+## 🚀 Install
+
+Requires **Python 3.11–3.13**.
+
+```bash
+pip install elidia-agent-cli
+```
+
+Prefer an isolated tool environment? Use [uv](https://docs.astral.sh/uv/) (recommended) or [pipx](https://pipx.pypa.io/):
+
+```bash
+uv tool install elidia-agent-cli
+# or
+pipx install elidia-agent-cli
+```
+
+To include every optional backend in one go (messaging platforms, web search, image generation, TTS, and more):
+
+```bash
+pip install "elidia-agent-cli[all]"
+```
+
+Then start:
+
+```bash
+elidia              # start chatting
+```
+
+> [!NOTE]
+> **Android / Termux:** see the [Termux guide](docs/termux.md). On Termux, install the curated extra that skips Android-incompatible voice dependencies:
+>
+> ```bash
+> pip install "elidia-agent-cli[termux]"
+> ```
+
+Full installation details: [docs/installation.md](docs/installation.md).
+
+---
+
+## 🏁 Getting Started
+
+```bash
+elidia              # Interactive CLI — start a conversation
+elidia model        # Choose your LLM provider and model
+elidia tools        # Configure which tools are enabled
+elidia config set   # Set individual config values
+elidia gateway      # Start the messaging gateway (Telegram, Discord, etc.)
+elidia setup        # Run the full setup wizard
+elidia claw migrate # Migrate from OpenClaw
+elidia update       # Update to the latest version
+elidia doctor       # Diagnose any issues
+```
+
+📖 **[Full documentation →](https://aiutils.io/elidia)** — or browse the in-repo guides below.
+
+---
+
+## 🎁 One subscription for everything — Elidia Portal
+
+Elidia works with any provider. If you'd rather not manage separate API keys for the model, web search, image generation, TTS, and a cloud browser, **[Elidia Portal](https://developer.aiutils.io)** covers them under one subscription:
+
+- **300+ models** — pick any with `/model <name>`
+- **Tool Gateway** — web search (Firecrawl), image generation (FAL), text-to-speech (OpenAI), cloud browser (Browser Use), all routed through your subscription.
+
+One command from a fresh install:
+
+```bash
+elidia setup --portal
+```
+
+That signs you in via OAuth, sets Elidia as your provider, and switches on the Tool Gateway. Check what's connected at any time with `elidia portal info`. Full details: [docs/elidia-portal.md](docs/elidia-portal.md) and [docs/tool-gateway.md](docs/tool-gateway.md).
+
+You can still bring your own keys per-tool whenever you like — the gateway is per-backend, not all-or-nothing.
+
+---
+
+## 🧭 CLI vs Messaging — Quick Reference
+
+Elidia has two entry points: start the terminal UI with `elidia`, or run the gateway and talk to it from Telegram, Discord, Slack, WhatsApp, Signal, or Email. Many slash commands work the same in both.
+
+| Action                         | CLI                                           | Messaging platforms                                                              |
+| ------------------------------ | --------------------------------------------- | -------------------------------------------------------------------------------- |
+| Start chatting                 | `elidia`                                      | Run `elidia gateway setup` + `elidia gateway start`, then send the bot a message |
+| Start fresh conversation       | `/new` or `/reset`                            | `/new` or `/reset`                                                               |
+| Change model                   | `/model [provider:model]`                     | `/model [provider:model]`                                                        |
+| Set a personality              | `/personality [name]`                         | `/personality [name]`                                                            |
+| Retry or undo the last turn    | `/retry`, `/undo`                             | `/retry`, `/undo`                                                                |
+| Compress context / check usage | `/compress`, `/usage`, `/insights [--days N]` | `/compress`, `/usage`, `/insights [days]`                                        |
+| Browse skills                  | `/skills` or `/<skill-name>`                  | `/<skill-name>`                                                                  |
+| Interrupt current work         | `Ctrl+C` or send a new message                | `/stop` or send a new message                                                    |
+| Platform-specific status       | `/platforms`                                  | `/status`, `/sethome`                                                            |
+
+For the full command lists, see the [CLI guide](docs/cli.md) and the [Messaging Gateway guide](docs/messaging.md).
+
+---
+
+## 📚 Documentation
+
+All documentation lives at **[aiutils.io/elidia](https://aiutils.io/elidia)** and as Markdown files in this repository's [`docs/`](docs/README.md) folder:
+
+| Section                                                                    | What's Covered                                             |
+| -------------------------------------------------------------------------- | ---------------------------------------------------------- |
+| [Installation](docs/installation.md)                                       | Linux, macOS, WSL2, Windows, Termux                        |
+| [Quickstart](docs/quickstart.md)                                           | Install → setup → first conversation in 2 minutes          |
+| [CLI Usage](docs/cli.md)                                                   | Commands, keybindings, personalities, sessions             |
+| [Configuration](docs/configuration.md)                                     | Config file, providers, models, all options                |
+| [Messaging Gateway](docs/messaging.md)                                     | Telegram, Discord, Slack, WhatsApp, Signal, and more       |
+| [Security](docs/security.md)                                               | Command approval, DM pairing, container isolation          |
+| [Tools & Toolsets](docs/tools.md)                                          | 40+ tools, toolset system, terminal backends               |
+| [Skills System](docs/skills.md)                                            | Procedural memory, Skills Hub, creating skills             |
+| [Memory](docs/memory.md)                                                   | Persistent memory, user profiles, best practices           |
+| [MCP Integration](docs/mcp.md)                                             | Connect any MCP server for extended capabilities           |
+| [Cron Scheduling](docs/cron.md)                                            | Scheduled tasks with platform delivery                     |
+| [Context Files](docs/context-files.md)                                     | Project context that shapes every conversation             |
+| [Elidia Portal](docs/elidia-portal.md)                                     | One subscription, 300+ models, Tool Gateway                |
+| [Migrating from OpenClaw](docs/migrate-from-openclaw.md)                   | Import settings, memories, skills, and API keys            |
+| [Architecture](docs/architecture.md)                                       | Project structure, agent loop, key classes                 |
+| [Contributing](docs/contributing.md)                                       | Development setup, PR process, code style                  |
+| [CLI Reference](docs/cli-commands.md)                                      | All commands and flags                                     |
+| [Environment Variables](docs/environment-variables.md)                     | Complete env var reference                                 |
+
+---
+
+## 🔄 Migrating from OpenClaw
+
+If you're coming from OpenClaw, Elidia can import your settings, memories, skills, and API keys.
+
+**During first-time setup:** the setup wizard (`elidia setup`) detects `~/.openclaw` and offers to migrate before configuration begins.
+
+**Anytime after install:**
+
+```bash
+elidia claw migrate              # Interactive migration (full preset)
+elidia claw migrate --dry-run    # Preview what would be migrated
+elidia claw migrate --preset user-data   # Migrate without secrets
+elidia claw migrate --overwrite  # Overwrite existing conflicts
+```
+
+What gets imported:
+
+- **SOUL.md** — persona file
+- **Memories** — MEMORY.md and USER.md entries
+- **Skills** — user-created skills → `~/.elidia/skills/openclaw-imports/`
+- **Command allowlist** — approval patterns
+- **Messaging settings** — platform configs, allowed users, working directory
+- **API keys** — allowlisted secrets (Telegram, OpenRouter, OpenAI, Anthropic, ElevenLabs)
+- **TTS assets** — workspace audio files
+- **Workspace instructions** — AGENTS.md (with `--workspace-target`)
+
+See [docs/migrate-from-openclaw.md](docs/migrate-from-openclaw.md) for the complete guide.
+
+---
+
+## 📦 Repository & Releases
+
+This public repository hosts the **packaged releases and documentation** for Elidia Agent. The source code is developed in a private repository and distributed as build artefacts on [PyPI](https://pypi.org/project/elidia-agent-cli/).
+
+- **Latest release:** see the [Releases](https://github.com/Elidia-Technology/elidia-agent-cli-v2/releases) page for the current `.whl` and `.tar.gz` build artefacts.
+- **Documentation:** [aiutils.io/elidia](https://aiutils.io/elidia)
+- **Developer console:** [developer.aiutils.io](https://developer.aiutils.io)
+- **Report a bug / request a feature:** open an [Issue](https://github.com/Elidia-Technology/elidia-agent-cli-v2/issues)
+
+Contributions are welcome — see the [Contributing Guide](docs/contributing.md) for code style and the PR process. Since this repository does not host source code, please raise issues here rather than opening code PRs against it.
+
+---
+
+## 🤝 Community
+
+- 💬 [Discord](https://discord.gg/AiUtils)
+- 📚 [Skills Hub](https://agentskills.io)
+- 🔌 [computer-use-linux](https://github.com/avifenesh/computer-use-linux) — Linux desktop-control MCP server for Elidia and other MCP hosts.
+- 🔌 [ElidiaClaw](https://github.com/AaronWong1999/elidiaclaw) — community WeChat bridge: run Elidia Agent and OpenClaw on the same WeChat account.
+
+---
+
+## 📄 License
+
+MIT — see [LICENSE](LICENSE).
+
+---
+
+Built with ❤️ by [Elidia Technology Pvt. Ltd.](https://aiutils.io) — part of the [AiUtils.io](https://aiutils.io) ecosystem.