@eko-ai/eko-nodejs
Version:
Empowering language to transform human words into action.
122 lines (90 loc) • 4.65 kB
Markdown
<h1 align="center">
<a href="https://github.com/FellouAI/eko" target="_blank">
<img src="https://github.com/user-attachments/assets/55dbdd6c-2b08-4e5f-a841-8fea7c2a0b92" alt="eko-logo" width="200" height="200">
</a>
<br>
<small>Eko - Build Production-ready Agentic Workflow with Natural Language</small>
</h1>
[](LICENSE) [](https://example.com/build-status) [](https://eko.fellou.ai/docs/release/versions/)
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**.
## 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** | ✅ | ✅ | ❌ | ❌ | ❌ |
| **Development Efficiency** | **High** | Low | Middle | Middle | Low |
| **Task Complexity** | **High** | High | Low | Middle | Middle | Middle |
| **Open-source** | ✅ | ✅ | ✅ | ✅ | ❌ |
| **Access to private web resources** | ✅ | ❌ | ❌ | ❌ | ❌ |
## Features
- [x] Pure JavaScript: Built for browsers and Node.js.🚀
- [x] Multi-Agent: Unleash power with multiple Agents in one task.📈
- [x] Agent/Tool Flexibility: Customize new Agents and Tools in just one line.🎉
- [x] Native MCP: Connects seamlessly with [Awesome MCP Servers](https://mcpservers.org/).🔗
- [x] Dynamic LLM: Balance speed and performance with flexible model choices.⚙️
- [x] Human-in-the-loop: Intervene when it matters most.🤝
- [x] Stream Planning: Dynamic rendering made easy.🎨
- [x] Loop & Listener Tasks: Automate any repetitive task.🤖
- [ ] Observable Chain: *Coming soon*
- [ ] Native A2A: *Coming soon*
## Quickstart
> **Note**: Please refer to the [Eko Quickstart guide](https://eko.fellou.ai/docs/getting-started/quickstart/) 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
```typescript
const llms: LLMs = {
default: {
provider: "anthropic",
model: "claude-sonnet-4-20250514",
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");
```
```bash
$ pnpm install @eko-ai/eko
```
## 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](https://eko.fellou.ai/docs) 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](https://github.com/FellouAI/eko/issues)
- Join our [slack community discussions](https://join.slack.com/t/eko-ai/shared_invite/zt-2xhvkudv9-nHvD1g8Smp227sM51x_Meg)
- Join our [Discard](https://discord.gg/XpFfk2e5):
- Contribute tools and improvements
- Share your use cases and feedback
[](https://star-history.com/#FellouAI/eko&Date)
## License
Eko is released under the MIT License. See the [LICENSE](LICENSE) file for details.