Eko - Build Production-ready Agentic Workflow with Natural Language

Eko (pronounced like 'echo') is a production-ready JavaScript framework that enables developers to create reliable agents, from simple commands to complex workflows. It provides a unified interface for running agents in both computer and browser environments.

News

• 2025-09: Eko 3.0 introduces dependency-aware parallel agent execution.
• 2025-09: New pause, resume, and interrupt controls with task_snapshot workflow recovery.
• 2025-09: Monorepo tooling migrated to pnpm for consistent workspace management.

Upgrading to Eko 3.0

Follow these steps when moving an existing Eko 2.x project to 3.0:

1. Update dependencies with pnpm up @eko-ai/eko @eko-ai/eko-nodejs @eko-ai/eko-web @eko-ai/eko-extension.
2. Regenerate saved workflows or exported plans so they use the v3 schema and dependency graph format.
3. Clean and reinstall using pnpm (rm -rf node_modules && pnpm install), then rebuild any browser or desktop bundles.
4. Re-run automated demos and update documentation to reflect the new pause/interrupt APIs and parallel agent behavior.

Framework Comparison

Feature	Eko	Langchain	Browser-use	Dify.ai	Coze
Supported Platform	All platform	Server side	Browser	Web	Web
One sentence to multi-step workflow	✅	❌	✅	❌	❌
Intervenability	✅	✅	❌	❌	❌
Task Parallel	✅	❌	❌	❌	❌
Development Efficiency	High	Low	Middle	Middle	Low
Task Complexity	High	High	Low	Middle	Middle
Open-source	✅	✅	✅	✅	❌
Access to private web resources	✅	❌	❌	❌	❌

Features

• Pure JavaScript: Built for browsers and Node.js.🚀
• Multi-Agent: Unleash power with multiple Agents in one task.📈
• Agent/Tool Flexibility: Customize new Agents and Tools in just one line.🎉
• Native MCP: Connects seamlessly with Awesome MCP Servers.🔗
• Dynamic LLM: Balance speed and performance with flexible model choices.⚙️
• Human-in-the-loop: Intervene when it matters most.🤝
• Stream Planning: Dynamic rendering made easy.🎨
• Loop & Listener Tasks: Automate any repetitive task.🤖
• Observable Chain: Coming soon
• Native A2A: Coming soon

Quickstart

Note: Please refer to the Eko Quickstart guide guide for full instructions on how to run it.

Security Warning

DO NOT use API Keys in browser/frontend code!

This will expose your credentials and may lead to unauthorized usage.

Best Practices: Configure backend API proxy request through baseURL and request headers.

Please refer to the link: https://eko.fellou.ai/docs/getting-started/configuration#web-environment

const llms: LLMs = {
  default: {
    provider: "anthropic",
    model: "claude-sonnet-4-20250514",
    apiKey: "your-api-key"
  },
  gemini: {
    provider: "google",
    model: "gemini-2.5-pro",
    apiKey: "your-api-key"
  },
  openai: {
    provider: "openai",
    model: "gpt-5",
    apiKey: "your-api-key"
  }
};

let agents: Agent[] = [new BrowserAgent(), new FileAgent()];
let eko = new Eko({ llms, agents });
let result = await eko.run("Search for the latest news about Musk, summarize and save to the desktop as Musk.md");

$ pnpm install @eko-ai/eko

Example Projects

The repository ships with three workspace examples under the example/ folder. After running the core install (pnpm install) you can launch any of them with the commands below. Each example consumes the local 3.0 packages, so rebuilding the main workspace automatically refreshes them.

Browser Extension (example/extension)

pnpm --filter @eko-ai/eko-extension build
pnpm --filter @eko-ai/eko-extension-example run build

Load the generated example/extension/dist directory via chrome://extensions → Developer Mode → Load unpacked. Configure your API key in the extension options before running the automation task.

Node.js Automation (example/nodejs)

pnpm --filter @eko-ai/eko-nodejs-example run build
pnpm --filter @eko-ai/eko-nodejs-example run playwright   # first time only, installs browsers
OPENAI_API_KEY=... ANTHROPIC_API_KEY=... pnpm --filter @eko-ai/eko-nodejs-example run start

The Node.js demo drives Playwright through Eko; provide at least one model API key before running it.

Web Login Demo (example/web)

pnpm --filter @eko-ai/eko-web-example run start

This starts a React dev server on the default port with a simple login flow that you can automate with the browser or web agents.

Use Cases

• Browser automation and web scraping
• System file and process management
• Workflow automation
• Data processing and organization
• GUI automation
• Multi-step task orchestration

Documentation

Visit our documentation site for:

• Getting started guide
• API reference
• Usage examples
• Best practices
• Configuration options

Development Environments

Eko can be used in multiple environments:

• Browser Extension
• Web Applications
• Node.js Applications

Community and Support

• Report issues on GitHub Issues

Community Spotlight

• Career Co-Pilot: https://github.com/wangwangbobo/career_skill_learnig.git
• Slides Agent by Eko: https://github.com/MICAHFANG/slides-agent-by-eko
• Universal Sidebar Assistant: https://github.com/San12341/eko-broser-extension.git
• 48 Hour Browser Challenge: https://github.com/MoonIRL/eko
• Orbit X Smart Terminal: https://github.com/Skywang16/OrbitX/tree/main
• EkoMeet Recommender: https://github.com/JasonRobertDestiny/EkoMeet
• Vision-Eko Plugin: https://github.com/dcpwilliam/vision-eko/tree/main/serviceNowPlugin
• IC Cafe Platform: https://cnb.cool/giggle_giraffe/ic-info-wxapp
• AI Monitoring Assistant: https://github.com/yuhoudecheqiancao/eko-ai-monitoring

License

Eko is released under the MIT License. See the LICENSE file for details.