Skip to main content

Lightweight provider-agnostic agentic coding backend (CLI + server) for the Euron VS Code extension.

Project description

euron-coding-agent

The Python agent backend and standalone CLI behind the Euron Coding Agent VS Code extension. An open-source, model-agnostic agentic coding assistant that plans, edits code, runs commands, searches the web, reviews diffs, coordinates teams of sub-agents, and runs on cron schedules - with your approval at every step.

Provider-agnostic: works with Anthropic, OpenAI, Google Gemini, OpenRouter, Groq, Cerebras, DeepSeek, Together, Mistral, xAI, Vercel AI Gateway, Euron/Euri, Ollama, LM Studio, or any OpenAI-compatible / self-hosted endpoint.

Install

pip install euron-coding-agent
euron-agent update                            # update to the latest anytime
# optional extras:
pip install "euron-coding-agent[anthropic]"   # native Anthropic client
pip install "euron-coding-agent[mcp]"         # Model Context Protocol servers

Tip: install into a virtual environment for isolation. The client auto-adapts to each provider's API (e.g. models needing max_completion_tokens instead of max_tokens, or rejecting a custom temperature) - no model-specific config needed.

Quick start (CLI)

euron-agent                                    # interactive chat in the current folder
euron-agent run "add a /health route to app.py"
euron-agent run "summarize the repo" --json     # headless JSON output for CI/scripts
euron-agent serve --host 0.0.0.0 --port 8000    # self-host with bearer-token auth

Set a provider and key right inside the chat (no files needed):

you: /provider openai      # or gemini, anthropic, groq, ollama, ...
you: /key                  # paste your API key (stored in ~/.euron-agent)
you: create a FastAPI hello-world app with a test

Or use environment variables (OPENAI_API_KEY, ANTHROPIC_API_KEY, GEMINI_API_KEY, EURI_API_KEY, ...) or a config.yaml. Built-in provider profiles mean no config file is required - just pick a provider and supply a key.

CLI commands

euron-agent                     interactive chat (remembers provider/key)
euron-agent run "<task>"        one-shot task ( --yes to auto-approve, --json headless )
euron-agent providers           list configured providers
euron-agent init                scaffold config.yaml + .env
euron-agent serve               run the API / WebSocket server ( --port 0 = auto )
euron-agent --team-name <name> "<task>"   multi-agent team (coordinator + specialists)
euron-agent team                list multi-agent teams
euron-agent schedule create "<name>" --cron "0 9 * * MON-FRI" --prompt "<task>"
euron-agent schedule list | run <id> | remove <id> | daemon
euron-agent plugin add <dir|zip-url> | list | remove <name>
euron-agent sessions            list saved sessions (dashboard)
euron-agent chat --session <id> | --resume   resume a past session

In-chat commands: /provider /key /model /effort /plan /review /compact /init /skills /search /usage /undo /reset /yes /help /exit, plus any custom command in .euron/commands/.

Features

  • Agentic tool-calling loop: plan, read, search, edit, run, verify.
  • 28 sandboxed tools: read/write/edit/multi_edit/create/delete files, glob, search, run_command (streaming), background processes, git status/diff/commit/ branch/push, open_pr, git worktrees, web_search, web_fetch.
  • Plan mode, sub-agents, and multi-agent teams with persistent state.
  • Scheduled agents on cron schedules (independent of any terminal).
  • MCP servers, plugins, skills, project memory (AGENTS.md), and custom commands.
  • Permissions (allow/ask/deny), hooks, approvals with diffs, checkpoints, undo.
  • Web search/fetch, multimodal image input, token and cost tracking, extended thinking, model fallback chains.
  • Messaging notifications: Slack, Discord, Telegram, Google Chat, WhatsApp, Linear.
  • Headless JSON mode and a self-hostable server with bearer-token auth.

Server

  • GET /health liveness.
  • GET /providers configured providers.
  • POST /agent/run one-shot, non-interactive (set "auto_approve": true).
  • WS /ws streaming agent with per-action approval (used by the extension).

The WebSocket init message accepts provider, model, api_key, and base_url so secrets never need to live on disk. Set EURON_AGENT_TOKEN (or serve --token) to require bearer auth.

See the project README at https://github.com/euron-tech/Euron-coding-agent for the full architecture and the VS Code extension.

License

Apache License 2.0. Copyright 2026 Euron Engage Sphere Technology Private Limited.

Project details


Download files

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

Source Distribution

euron_coding_agent-1.0.6.tar.gz (71.6 kB view details)

Uploaded Source

Built Distribution

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

euron_coding_agent-1.0.6-py3-none-any.whl (71.6 kB view details)

Uploaded Python 3

File details

Details for the file euron_coding_agent-1.0.6.tar.gz.

File metadata

  • Download URL: euron_coding_agent-1.0.6.tar.gz
  • Upload date:
  • Size: 71.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for euron_coding_agent-1.0.6.tar.gz
Algorithm Hash digest
SHA256 5a0cd8fff8df3764ecdb1bc64633af58296a1af6651bfcaeb7e1f9f07a223a10
MD5 575357f1c16763bfefc551082e06116e
BLAKE2b-256 a7e1f7f6de9ca0915f77692c66232e6daf215c11f4e3dd68f14aa9e82d8db912

See more details on using hashes here.

File details

Details for the file euron_coding_agent-1.0.6-py3-none-any.whl.

File metadata

File hashes

Hashes for euron_coding_agent-1.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a5856cce4fa9532acf082d65b667b583187349b9dac3c05ff1f157e6006e8495
MD5 9f5937292facee9d9e5382777960a945
BLAKE2b-256 3352eb409676eaaf32292be318ee881065373b042c348a3e34eba536ea75bf5c

See more details on using hashes here.

Supported by

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