flue

The sandbox agent framework.

23 articles 3.2k View on GitHub ↗
23 articles
How to Use Event Callbacks for Monitoring and Debugging Agent Execution in Flue

Learn to monitor and debug agent execution in Flue using event callbacks subscribeEvent and setEventCallback for comprehensive insight into your agent's lifecycle.

how-to-guide
May 11, 2026
Orchestrating Multiple Agents in Flue: Task Sessions and Parent-Child Relationships Explained

Master orchestrating multiple agents in Flue with task sessions and parent-child relationships. Build complex, parallel multi-agent workflows with isolated sessions and secure communication.

deep-dive
May 11, 2026
Configuring Multiple Model Providers with Provider-Specific Settings in Flue

Configure multiple LLM model providers with Flue's registerProvider and configureProvider. Route traffic to local Ollama, custom gateways, or Cloudflare Workers AI without rebuilding.

how-to-guide
May 11, 2026
Mounting Cloudflare R2 Buckets as Read-Only Knowledge Base Filesystems with Flue

Mount Cloudflare R2 buckets as read-only knowledge base filesystems with Flue. Combine SQLite Durable Objects and R2 binding for tool-based search operations.

how-to-guide
May 11, 2026
Handling Errors, Timeouts, and Retries in Flue Agent Operations

Learn how to handle errors timeouts and retries in Flue agent operations withastro/flue. Discover FlueError hierarchy AbortSignal and automatic retries for LLM calls.

how-to-guide
May 11, 2026
How to Integrate the Daytona Connector for Full Linux Container Sandboxes in Flue

Integrate the Daytona connector with Flue to run commands in isolated Linux containers. Enhance your agent's capabilities beyond the default Bash environment today.

how-to-guide
May 11, 2026
Configuring Build Targets for Node.js and Cloudflare Workers Deployment in Flue

Configure build targets for Node.js and Cloudflare Workers with Flue using the --target flag. Deploy identical agent code to both runtimes effortlessly. Learn how now.

how-to-guide
May 11, 2026
Organizing Flue Agents: .flue Directory Layout vs Root-Level Layout

Discover Flue's agent organization options: master `.flue` directory layout versus root-level `agents` and `roles` folders. Optimize your project structure effortlessly.

architecture
May 11, 2026
Implementing Custom Session Stores for Persistent Conversation State in Flue

Learn to implement custom session stores in Flue to persist conversation state across server restarts. Override save load and delete methods with the SessionStore interface.

how-to-guide
May 11, 2026
Using Valibot Schemas for Validating and Typing Agent Responses in Flue

Leverage Valibot schemas in Flue to validate and type LLM agent responses, ensuring robust and predictable outputs. Convert schemas to tool definitions and parse responses with safeParse for typed validation.

how-to-guide
May 11, 2026
Implementing Server-Sent Events Streaming for Real-Time Agent Output in Flue

Implement Server-Sent Events streaming in Flue for real-time LLM output monitoring. Stream agent events and results over HTTP, eliminating the need for polling and enhancing your application's responsiveness.

tutorial
May 11, 2026
Using the Flue Local Sandbox in CI/CD Environments with Host Filesystem Access

Unlock Flue local sandbox capabilities in CI/CD. Access host filesystem directly, read repo files, and write artifacts with Node.js fs/promises API, eliminating virtual layer overhead.

how-to-guide
May 11, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"

Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →