https://github.com/bkataru/pocketflow-zig
Pocket Flow: A minimalist LLM framework. Let Agents build Agents!
https://github.com/bkataru/pocketflow-zig
agentic-ai agentic-framework agentic-workflow agents ai-framework ai-frameworks aiagent aiagents artificial-intelligence flow-based-programming flow-engineering large-language-model large-language-models llm-agent llm-framework pocket-flow pocketflow retrieval-augmented-generation workflow workflow-orchestration
Last synced: 2 months ago
JSON representation
Pocket Flow: A minimalist LLM framework. Let Agents build Agents!
- Host: GitHub
- URL: https://github.com/bkataru/pocketflow-zig
- Owner: bkataru
- License: mit
- Created: 2025-10-26T09:02:18.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-10-31T10:28:26.000Z (2 months ago)
- Last Synced: 2025-10-31T12:18:29.703Z (2 months ago)
- Topics: agentic-ai, agentic-framework, agentic-workflow, agents, ai-framework, ai-frameworks, aiagent, aiagents, artificial-intelligence, flow-based-programming, flow-engineering, large-language-model, large-language-models, llm-agent, llm-framework, pocket-flow, pocketflow, retrieval-augmented-generation, workflow, workflow-orchestration
- Language: Zig
- Homepage:
- Size: 679 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
A Zig implementation of [PocketFlow](https://github.com/The-Pocket/PocketFlow), a minimalist flow-based programming framework.
## Overview
mention how it's a port of the original python package, but how it differs from that having been written/ported to zig due to zig's unique capabilities
## Features
- exploits comptime well?
- multithreaded?
- uses state machines?
## Quick Start
### 0. Setup
```bash
```
### 1. Define Custom States
```zig
```
### 2. Implement Nodes
```zig
```
### 3. Build Flows
```zig
```
### 4. Batch Processing
```zig
```
## Advanced Usage
### Custom State Management
Define your own states to control flow transitions:
```zig
```
### Complex Flow Construction
Build complex workflows with multiple nodes and state transitions:
```zig
```
## Examples
Check out the `examples/` directory for more detailed examples:
- basic.zig: Basic flow with custom states
- text2sql: Text-to-SQL workflow example
- [pocketflow-zig-rag](./examples/pocketflow-zig-rag/README.md): Retrieval-Augmented Generation (RAG) workflow example
## Development
### Building the Project
```bash
```
### Running Tests
```bash
```
## Contributing
Contributions are welcome! We're particularly looking for volunteers to:
1. Implement asynchronous operation support
- e.g., using one or more of state machines, event loops (io_uring, libuv, etc.), and the new Zig 0.15.1 Async I/O interface.
2. Add more comprehensive test coverage, including edge cases and error handling.
3. Improve documentation and provide more complex examples (e.g., LLM integration stubs).
4. Refine the API for better Zig idiomatic usage if applicable.
Please feel free to submit pull requests or open issues for discussion.
## License
[MIT License](LICENSE)