Skip to main content

Elidia Agent

Elidia Agent

PyPI Documentation Developer Console Powered by Elidia Technology हिन्दी

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

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

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.

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 and the Messaging Gateway guide.


📚 Documentation

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

Section What's Covered
Installation Linux, macOS, WSL2, Windows, Termux
Quickstart Install → setup → first conversation in 2 minutes
CLI Usage Commands, keybindings, personalities, sessions
Configuration Config file, providers, models, all options
Messaging Gateway Telegram, Discord, Slack, WhatsApp, Signal, and more
Security Command approval, DM pairing, container isolation
Tools & Toolsets 40+ tools, toolset system, terminal backends
Skills System Procedural memory, Skills Hub, creating skills
Memory Persistent memory, user profiles, best practices
MCP Integration Connect any MCP server for extended capabilities
Cron Scheduling Scheduled tasks with platform delivery
Context Files Project context that shapes every conversation
Elidia Portal One subscription, 300+ models, Tool Gateway
Migrating from OpenClaw Import settings, memories, skills, and API keys
Architecture Project structure, agent loop, key classes
Contributing Development setup, PR process, code style
CLI Reference All commands and flags
Environment Variables 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:

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.

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.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

elidia_agent_cli-2.0.4.tar.gz (9.2 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

elidia_agent_cli-2.0.4-py3-none-any.whl (5.3 MB view details)

Uploaded Python 3

File details

Details for the file elidia_agent_cli-2.0.4.tar.gz.

File metadata

  • Download URL: elidia_agent_cli-2.0.4.tar.gz
  • Upload date:
  • Size: 9.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.12

File hashes

Hashes for elidia_agent_cli-2.0.4.tar.gz
Algorithm Hash digest
SHA256 31211b0604ff7e48e839fe0e6ff4aefed6964caf94bbab8329f5742aa24ceca5
MD5 894117d7e109e2831c76dc53d5e819de
BLAKE2b-256 8f1431004faf595bac18e26730c32e25fc545439bf377b89fc90f4023f051751

See more details on using hashes here.

File details

Details for the file elidia_agent_cli-2.0.4-py3-none-any.whl.

File metadata

File hashes

Hashes for elidia_agent_cli-2.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 affbe7f2f31526c7dd3949f3db3a046b02a01504f35ffcbb1b7fdb1ad55c8a76
MD5 d6c41354ff35fdacf871e4d5cb0d331f
BLAKE2b-256 97952af324225a2cb95cf64b3a7a93bdda2c9a59e321f9495a418e40adcd76c8

See more details on using hashes here.

Release history Release notifications | RSS feed

2.0.10

2 files

2.0.9

2 files

2.0.8

2 files

2.0.7

2 files

2.0.6

2 files

2.0.5

2 files

This release

2.0.4 This release

2 files

2.0.3

2 files

2.0.2

2 files

2.0.1

2 files

2.0.0

2 files

0.7.0

2 files

0.6.19

2 files

0.6.18

2 files

0.6.17

2 files

0.6.16

2 files

0.6.15

2 files

0.6.14

2 files

0.6.13

2 files

0.6.12

2 files

0.6.11

2 files

0.6.10

2 files

0.6.9

2 files

0.6.8

2 files

0.6.7

1 file

0.6.6

1 file

0.6.5

1 file

0.6.4

1 file

0.6.3

1 file

0.6.2

1 file

0.6.1

1 file

0.6.0

1 file

0.5.2

1 file

0.5.1

1 file

0.5.0

1 file

0.4.9

2 files

0.4.8

2 files

0.4.7

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page