flue README

The project's README from github.com/withastro/flue. As one markdown file: README.md.

Flue — The Agent Harness Framework

Not another SDK. Build autonomous agents with Flue's programmable TypeScript harness.

// agents/triage.ts
'use agent';
import { useModel, useSandbox, useSkill, useTool } from '@flue/runtime';
import { local } from '@flue/runtime/node';
import triage from '../skills/triage/SKILL.md';
import verify from '../skills/verify/SKILL.md';
import { openIssue, searchCode } from '../tools/github.ts';

// The agent IS the function. Compose the complete harness it needs to do
// real work, complete with virtual, local, or remote container sandbox.
export function Triage() {
  useModel('anthropic/claude-sonnet-4-6');
  useSandbox(local());
  useSkill(triage);
  useSkill(verify);
  useTool(openIssue);
  useTool(searchCode);

  // Give agents the context and autonomy to solve complex tasks:
  return `
Triage a bug report end-to-end: reproduce the bug,
diagnose the root cause, verify whether the behavior is
intentional, and attempt a fix.

...`;
}

The framework for building the next generation of agents.

The first agents were built with raw LLM API calls. This worked for simple chatbots and scripted tasks, but not much else.

Agents like Claude Code and Codex broke the mold. These were real agents. Autonomous. You give them a task — not a pre-defined series of steps — and trust them to complete it using the context and tools that you provide.

Flue unlocks this new architecture for agents. Its built-in TypeScript harness gives any model the context and environment it needs for truly autonomous work: sessions, tools, skills, instructions, filesystem access, and a secure sandbox to run in. Run your agents locally via CLI or deploy them to your hosted runtime of choice.

Features

Build agents that can safely take action, maintain continuity, and connect to the systems where work already happens.

Deploy Anywhere

Packages

Package Description
@flue/runtime Runtime: harness, sessions, tools, sandbox
@flue/vite Vite plugin: vite dev / vite build for Node and Cloudflare
@flue/cli CLI (flue binary): local runs, blueprints, offline docs
@flue/sdk Client SDK for consuming deployed agent conversations
@flue/opentelemetry OpenTelemetry tracing adapter
@flue/postgres Postgres persistence adapter

flue (withastro/flue)

Searching Database…

8.5K ·GitHub
Flue
Что это такое?Flue — это фреймворк на TypeScript для создания автономных ИИ-агентов. Агенты получают безопасную песочницу, сессии, инструменты, навыки и доступ к файловой системе, а не только голые вызовы API LLM.
Это фреймворк или SDK?Flue называет себя фреймворком для agent harness, а не SDK. Он сам включает среду выполнения, инструменты, песочницу и управление сессиями, а не просто оборачивает вызовы LLM.
Как мне начать создавать агента на Flue?Подключите пакет @flue/cli, чтобы получить бинарный файл 'flue' для локальных запусков, шаблонов (blueprints) и офлайн-документации, а также @flue/vite для поддержки 'vite dev' и 'vite build' на Node или Cloudflare.
Что нужно установить, чтобы работать с монорепозиторием Flue?Нужны Node.js 22+ и pnpm 11.x. Само ядро среды выполнения зависит от 'just-bash' и 'valibot'.
Нужна ли агенту дополнительная настройка, чтобы переживать перезапуски?Чтобы сохранять прогресс при сбоях и перезапусках, нужна функция долговечности (durability) с адаптером хранения данных, например @flue/postgres. Без него автоматическое восстановление не работает.
Где можно на самом деле развернуть агента Flue?Агентов можно запускать локально через CLI или разворачивать на Node.js, Cloudflare Workers, GitHub Actions, GitLab CI/CD, Daytona или Render.
Что такое Skills в Flue?Skills — это пакеты многократно используемых знаний и рабочих процессов, которые агент может подгрузить, когда задаче нужна специализированная инструкция. Работает похоже на навыки Claude Code.
Чем отличаются инструменты от субагентов?Инструменты — это типизированные действия для вызова API или контролируемых изменений. Субагенты — специализированные роли, которым основной агент может делегировать целые задачи.
Могу ли я подключить агентов к Slack или GitHub?Да. Функция Channels во Flue позволяет агентам получать проверенные события из Slack, Microsoft Teams, Discord, GitHub и других сервисов.
Как мне следить за тем, что делают мои агенты в продакшене?Flue экспортирует трассировки OpenTelemetry и имеет встроенные интеграции с Braintrust и Sentry. Также можно подключить собственный наблюдатель (observer).
What are similar projects?ruflo, open-multi-agent, trueforge, turnstone, Observal, cayu, tardigrade, go-micro
Which topics is it in?sentry, turborepo, durable-execution, tracing, telemetry, subagents, pnpm, cloudflare-workers, ci-cd, harness, agent-framework, github-actions
Creator
withastro
Size
18.6 MB
Stars
8.5K
Updated
CommitOct 12Release@flue/[email protected]Sep 28
Age
8mo
Commits · 90 Days