About Daydreams

⚠️ Warning: This is alpha software under active development. Expect frequent breaking changes and bugs. The API is not yet stable.

What is an AI Agent?

Think of an AI agent as a smart assistant that can:

• Listen for events (Discord messages, API calls, timers)
• Think about what to do (using AI models like GPT)
• Take action (call APIs, send responses, update databases)
• Remember what happened for future interactions

Real Examples

Here are some agents you could build with Daydreams:

Discord Weather Bot

// When someone says "what's the weather?"
// → Agent calls weather API
// → Agent responds: "It's 72°F and sunny in San Francisco"

Trading Assistant

// When market conditions change
// → Agent analyzes data
// → Agent executes trades or sends alerts

Customer Support Bot

// When customer sends message
// → Agent checks knowledge base
// → Agent provides help or escalates to human

How Daydreams Works

Daydreams provides the building blocks to create these agents:

• Contexts - Manage different conversation sessions or tasks
• Inputs - Listen for Discord messages, API calls, timers, etc.
• Outputs - Send responses via Discord, email, webhooks, etc.
• Actions - Call APIs, process data, perform calculations
• Memory - Remember conversations and learn from interactions

Why Choose Daydreams?

• TypeScript-first - Full type safety and IntelliSense support
• Model-agnostic - Works with OpenAI, Anthropic, Groq, and any AI SDK provider
• Production-ready - Built-in memory management, error handling, and concurrency
• Extensible - Pre-built extensions for Discord, Twitter, Telegram, and more

Get Started

Choose your path based on your experience:

New to AI Agents?

1. Building Blocks - Understand the core components with simple examples
2. Your First Agent - Build a working CLI echo bot
3. Agent Lifecycle - Learn how agents think and act

Ready to Build?

1. Installation - Set up your development environment
2. Examples - See complete working agents
3. API Reference - Detailed documentation for all features

Want to Understand the Architecture?

1. Core Concepts - Deep dive into the framework design
2. Advanced Features - Extensions, services, and customization