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

Uploaded Python 3

File details

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

File metadata

  • Download URL: euron_coding_agent-1.0.7.tar.gz
  • Upload date:
  • Size: 73.2 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.7.tar.gz
Algorithm Hash digest
SHA256 36bc48201c262cf7a5fe116ba790731d4463a5b44e48b4e41bda08302054d15c
MD5 9b0bb33796ce0cbb4d77d6a3f83804bd
BLAKE2b-256 05756bf78aede26f583ab6a6550871fd2793a0af6159b78f97431b9273383104

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for euron_coding_agent-1.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 689f15e7529f8334ee2d675774a2058af2e6542f117dce01873fb6567ceef2c4
MD5 a7b77bbdd31430c91b56a378902ad314
BLAKE2b-256 9c200fd85acaf6352f3d866e0fd5f1e46c5575691643fd1cc042fba80f54ffd4

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