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
# optional extras:
pip install "euron-coding-agent[anthropic]"   # native Anthropic client
pip install "euron-coding-agent[mcp]"         # Model Context Protocol servers

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.2.tar.gz (67.8 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.2-py3-none-any.whl (68.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: euron_coding_agent-1.0.2.tar.gz
  • Upload date:
  • Size: 67.8 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.2.tar.gz
Algorithm Hash digest
SHA256 d86eb0b4fe3979ba2ed768bcf5cb9b8d6e596c97925511655da90cbdaff34bf4
MD5 0b00b7a02e7712be66853bcebd89aa87
BLAKE2b-256 276a973575f89500257bb8a994bdec955bb5991bf1c02b1d0d07c90c89abb871

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for euron_coding_agent-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 70d37711d57849c14d8d317ba3cd4613394f9094c8e418718da6eb7a7f431503
MD5 d9bd615f088b78db15c8a0f4f8237d4f
BLAKE2b-256 d7842eb23e79751cd5d3921cd6c7cd649d6eae34e48a14b5980866a6be115c8b

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