elidia-agent-cli 2.0.8

Elidia Agent is a multi-platform AI agent for your terminal and messaging apps. It is part of the AiUtils.io ecosystem and powered by Elidia Technology Pvt. Ltd.

Use it with the model provider you already work with — Elidia Portal, OpenRouter (200+ models), NovitaAI, NVIDIA NIM, Xiaomi MiMo, z.ai/GLM, Kimi/Moonshot, MiniMax, Hugging Face, OpenAI, or your own endpoint. Switch with elidia model — no code changes, no lock-in.

✨ Features

🚀 Install

Requires Python 3.11–3.13.

pip install elidia-agent-cli

Prefer an isolated tool environment? Use uv (recommended) or pipx:

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):

pip install "elidia-agent-cli[all]"

Then start:

elidia              # start chatting

[!NOTE] Android / Termux: see the Termux guide. On Termux, install the curated extra that skips Android-incompatible voice dependencies:

pip install "elidia-agent-cli[termux]"

Full installation details: docs/installation.md.

🏁 Getting Started

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 → — 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 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:

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

For the full command lists, see the CLI guide and the Messaging Gateway guide.

📚 Documentation

All documentation lives at aiutils.io/elidia and as Markdown files in this repository's docs/ folder:

🔄 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:

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

• Latest release: see the Releases page for the current .whl and .tar.gz build artefacts.
• Documentation: aiutils.io/elidia
• Developer console: developer.aiutils.io
• Report a bug / request a feature: open an Issue

Contributions are welcome — see the Contributing Guide 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.

📄 License

MIT — see LICENSE.

Built with ❤️ by Elidia Technology Pvt. Ltd. — part of the AiUtils.io ecosystem.