Metadata-Version: 2.4
Name: orkes
Version: 0.1.2
Summary: Lightweight multi-agent orchestration framework
Author-email: Hasby Fahrudin <fahrudinhasby12@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/hfahrudin/orkes
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic>=2.0
Dynamic: license-file

# Orkes

## 🔍 What is Orkes?

**Orkes** helps you coordinate LLM agents using plain Python.
No magic, no unnecessary layers. Just **explicit control flow**, **transparent agent logic**, and **simple message passing**.

## 📝 Background

A while back, I was tasked with ensuring that our agentic-based streaming calls closed properly when a client disconnected.

Out of the box, there wasn’t a straightforward way to close the underlying HTTP connection. Why does this matter?

Because in our case, leaving connections hanging was detrimental to keeping our self-hosted LLM stable and reliable.

The frustrating part: today’s higher level libraries are abstractions on top of abstractions, hidden under even more abstractions, and at the end hidden in dependencies abstraction, layered until a simple fix turns into a complete clusterfuck.

Hence the pain of using high-level abstraction frameworks, some niche cases just don’t get covered.

## 📚 Documentation

* [orkes.agents](orkes/agents/docs.md) – Documentation for agent classes, interfaces, and tool integration.
* [orkes.graph](orkes/graph/docs.md) – Guides for building, compiling, and running DCG-based workflows with OrkesGraph.
* [orkes.services](orkes/services/docs.md) – Details on LLM connections, prompt handling, and response parsing services.

## 🔹 Core Principles

* **Explicit control flow** — use DCGs, FSMs, or plain loops
* **Transparent agents** — define prompt, tool, and logic directly
* **Simple message passing** — plain dicts, no graph state magic
* **Minimal dependencies** — only what you truly need
* **100% Pythonic** — easy to read, modify, and extend
* **Stateless by default** — you control memory and state
* **Hackable and debuggable** — nothing hidden

## 🛠️ Project Status

This is the initial stage of Orkes.

* [x] Vision and core philosophy
* [x] Elementary Directed Cyclic Graph orchestration engine
* [x] Agent structure (prompt + tool + fn)
* [x] LLM related interfaces
* [x] Minimal examples
* [x] Documentations

## License

This poject is available as open source under the terms of the [MIT License](https://github.com/hfahrudin/orkes/blob/main/LICENSE).

