playbooks 0.4.0

A framework for creating AI applications and agents using natural language programming

Create AI agents with natural language programs

Playbooks AI is a powerful framework for building AI agents with Natural Language Programming. It introduces a new "english-like", semantically interpreted programming language with reliable, auditable execution.

Playbooks AI is still in early development. We're working hard and would love your feedback and contributions.

Playbooks AI goes well beyond LLM tool calling. You can fluidly combine:

• Business processes written as natural language playbooks
• Python code for external system integrations, algorithmic logic, and complex data processing
• Multiple local and remote AI agents interacting in novel ways

Unlike standard LLM prompts that offer no execution guarantees, Playbooks provides full visibility into every step of execution, ensuring your AI system follows all rules, executes steps in the correct order, and completes all required actions. Track and verify the entire execution path with detailed state tracking, call stacks, and execution logs.

🚀 Key Features

• Natural Language Programming - Write agent logic in plain English with markdown playbooks that look like a step-by-step recipe
• Python Integration - Seamlessly call natural language and Python playbooks on the same call stack for a radically new programming paradigm
• Multi-Agent Architecture - Build systems with multiple specialized agents, interact and leverage external AI agents
• Event-Driven Programming - Use triggers to create reactive, context-aware agents
• Variables, Artifacts and Memory - Native support for managing agent state using variables, artifacts and memory
• Execution Observability - Full audit trail of every step of execution and explainability for every decision made by the AI agent

🏁 Quick Start

Installation

pip install playbooks

Create Your First Playbook

Create a file named hello.pb:

# Personalized greeting
This program greets the user by name

## Greet
### Triggers
- At the beginning of the program
### Steps
- Ask the user for their name
- Say hello to the user by name and welcome them to Playbooks AI
- End program

Run Your Playbook

python -m playbooks.applications.agent_chat hello.pb --verbose

VSCode Support (Optional)

Install the Playbooks Language Support extension for Visual Studio Code:

1. Open VSCode
2. Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
3. Search for "Playbooks Language Support"
4. Click Install

The extension provides debugging capabilities for playbooks programs, making it easier to develop and troubleshoot your AI agents. Once the plugin is installed, you can open a playbooks .pb file and start debugging!

📚 Documentation

Visit our documentation for comprehensive guides, tutorials, and reference materials.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributors