https://github.com/leopc1977/eklesia
Eklesia is a library for orchestrating AI agent interactions in simulated environments across any backend or local setup.
https://github.com/leopc1977/eklesia
ai-agents ai-research bun javascript large-language-models llm multi-agent-systems orchestration simulation typescript
Last synced: about 2 months ago
JSON representation
Eklesia is a library for orchestrating AI agent interactions in simulated environments across any backend or local setup.
- Host: GitHub
- URL: https://github.com/leopc1977/eklesia
- Owner: Leopc1977
- License: mit
- Created: 2025-08-19T15:43:45.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-09-05T17:43:12.000Z (10 months ago)
- Last Synced: 2025-09-05T19:31:12.648Z (10 months ago)
- Topics: ai-agents, ai-research, bun, javascript, large-language-models, llm, multi-agent-systems, orchestration, simulation, typescript
- Language: TypeScript
- Homepage: https://leopc1977.github.io/Eklesia-docs/
- Size: 71.3 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Eklesia
> ⚠️ Work in progress. Use at your own risk :)
> 📝 This README is temporary and subject to change.
Eklesia was originally conceived as a **TypeScript rewrite of [ChatArena](https://github.com/Farama-Foundation/chatarena)** by the [Farama Foundation](https://github.com/Farama-Foundation), which defines multi-agent environments using Arena, Environment, Backend and Player abstractions. However, Eklesia already diverges by introducing an explicit **Orchestrator** layer, an architectural component that coordinates agents, environments, and interaction flows, making the system more modular and backend-agnostic.
---
## Origin & Differences
- **Origin**: Inspired by [ChatArena](https://github.com/Farama-Foundation/chatarena) (Python, multi-agent language game framework) and rewritten in TypeScript.
- **Key architectural differences**:
- Introduction of an explicit **Orchestrator** to manage interactions between agents and environments.
- Backend-agnostic design (compatibility with Elysia, Next.js, Bun, etc.).
- Extensible support for not just chat but also games and other interaction paradigms.
---
## Features
- **Multi-Agent Orchestration**: Easily manage multiple AI agents in the same environment.
- **Simulated Environments**: Build or plug in different environments (chat, games, arenas…).
- **Backend Agnostic**: Works with Elysia, Next.js, local setups, or any transport layer.
- **Extensible**: Add new agents, environments, or interaction patterns effortlessly.
---
## Installation
```bash
bun install eklesia
```
---
### Quick Start
```js
import { ... } from 'eklesia';
```
---
### Examples
- Chat Arena: Multi-agent conversation simulation.
- Game Arena: Turn-based or real-time interactions between agents.
- Custom Environments: Plug your own environment logic with ease.
---
### Contributing
Pull requests are welcome! Feel free to open issues for bugs, feature requests, or questions.
---
### Authors
- **Leopc1977** – *Initial work* – [GitHub](https://github.com/Leopc1977) – Discord: [Leopc1977](https://discordapp.com/users/399631094514843669)
---
### Acknowledgments
- Inspired by:
- [ChatArena](https://github.com/Farama-Foundation/chatarena) by [Farama Foundation](https://github.com/Farama-Foundation)
- [House](https://github.com/sausheong/house) by [sausheong](https://github.com/sausheong)
- [game_arena](https://github.com/google-deepmind/game_arena) by [Google DeepMind](https://github.com/google-deepmind)
- Special thanks to the AI & dev communities for ideas and feedback.
---
### License
This project is licensed under the MIT License - see the [LICENSE.md](./LICENSE.md) file for details