Korben

What is Korben?

Korben is a hackable personal automation framework built on ControlFlow and Prefect. It features an auto-discovery plugin system that makes building powerful automation workflows incredibly simple.

Key Features

• Zero-Config Plugins: Auto-discovers and registers tasks from src/plugins/ - just write code and run
• AI-Native Automation: Built-in intelligent agents via ControlFlow for complex reasoning
• Composable Architecture: Generic building blocks that combine into powerful workflows
• Batteries Included: Pre-built plugins for podcasts, movies, books, security news, email, and more
• Cloud-Ready: Optional deployment to Prefect Cloud for scheduling and monitoring

Built-In Capabilities

• Podcasts: Download, transcribe, extract wisdom, email summaries
• Movies: Discover trending movies from TMDB with custom filters
• Books: Search and recommend books from ISBNdb
• arXiv Research: Search academic papers (free, no API key required)
• Mallory: Cybersecurity news fetching and summarization
• GitHub: Create and share gists from files or directories
• Linear: Ticket management and status reporting
• Google Calendar: Calendar event retrieval and management
• AWS S3: Bucket and file operations with lifecycle policies
• Share File: Quick file sharing via temporary public URLs
• Utilities: Generic tasks (file I/O, email, markdown conversion, AI extraction)
• Slack: Webhook notifications

Quick Examples

# List all available tasks and flows
python korben.py --list

# Run complete workflows
python korben.py --flow process_podcasts
python korben.py --flow mallory_trending_stories
python korben.py --flow trending_movies --genres "sci-fi,action"
python korben.py --flow arxiv_search --query "ti:transformer"

# Search and discover
python korben.py --task arxiv_search --query "all:quantum computing"
python korben.py --task discover_movies --min_rating 8.0
python korben.py --task search_books --query "artificial intelligence"

# Integrations and sharing
python korben.py --task get_linear_tickets --statuses "In Progress"
python korben.py --task create_gist_from_file --file_path script.py
python korben.py --task share_file --file document.pdf --expiration 7
python korben.py --task get_calendar_events --days 7

# Generic utilities
python korben.py --task extract_wisdom --text "Your text..."
python korben.py --task send_slack_hook --message "Hello!"

Plugin Architecture

Just create a folder in plugins with a tasks.py or flows.py file, and Korben automatically discovers and registers your functions. No configuration files to edit, no registry updates needed - it just works.

Korben’s plugin system makes extension trivial:

# Create a new plugin
mkdir -p src/plugins/weather

# Write tasks.py
echo 'def get_forecast(**kwargs):
    return "Sunny, 75°F"' > src/plugins/weather/tasks.py

# Done! Auto-discovered and ready to use
python korben.py --task get_forecast

Each plugin is self-contained with optional tasks.py, flows.py, lib.py, and config.yml files. No core modifications needed.

Get Started

Bing badda boom. Let’s get you moving.

Check out the GitHub repository to get started with Korben.

The project is MIT licensed and built for hackers who want powerful personal automation without the complexity.