AgentForge

Production-ready framework for building deep agents with LangGraph

AgentForge is a TypeScript framework that provides production-grade abstractions for building autonomous agents with LangGraph. It focuses on developer experience, type safety, and real-world production needs.

📚 View Full Documentation | 🚀 Quick Start Guide | 💡 Examples

✨ Features

✅ Complete & Production-Ready

Phase 1-2: Core Foundation

🛠️ Rich Tool Registry - Metadata-driven tools with automatic prompt generation
🔗 LangChain Integration - Seamless conversion between AgentForge and LangChain tools
📊 LangGraph State Management - Type-safe state utilities with Zod validation
🏗️ Workflow Builders - Sequential, parallel, and conditional workflow patterns
🔄 Error Handling Patterns - Retry, error handling, and timeout utilities
🧩 Subgraph Composition - Reusable subgraph utilities
💾 Memory & Persistence - Checkpointer and thread management utilities
📈 Observability - LangSmith integration, metrics, logging, and error handling

Phase 3: Agent Patterns

🤖 ReAct Pattern - Reasoning and Action loop for exploratory tasks
📋 Plan-Execute Pattern - Structured planning with parallel execution
🔍 Reflection Pattern - Iterative self-improvement through critique
👥 Multi-Agent Pattern - Coordinate specialized agents with supervisor routing

Phase 4-5: Advanced Features

🔌 Middleware System - Composable middleware for caching, rate limiting, validation
🌊 Streaming & Real-time - Stream transformers, aggregators, SSE, WebSocket, progress tracking
🛠️ Advanced Tools - Async execution, lifecycle management, composition, testing utilities
📦 Resource Management - Connection pooling, memory management, batch processing, circuit breaker
📊 Monitoring - Health checks, profiling, alerts, audit logging
🚀 Deployment - Docker, Kubernetes, CI/CD templates, multi-cloud guides

Phase 6: Developer Experience

🎯 CLI Tool - Project scaffolding, development, testing, deployment (156 tests, 98.11% coverage)
🧪 Testing Utilities - Mocks, assertions, fixtures for agent testing
📦 Standard Tools - 81 production-ready tools across 5 categories
🔒 Type Safety - Full TypeScript support with Zod schemas
📚 Comprehensive Tests - 2185 tests passing across all packages

Phase 7: Documentation

📖 Complete Documentation - 34 pages, 10,000+ lines of guides, tutorials, and API docs
💡 Pattern Guides - Detailed guides for all 4 agent patterns
🎓 Tutorials - 5 step-by-step tutorials from basics to advanced
📚 Examples - 6 complete working examples
🔍 API Reference - Full API documentation for all 5 packages

📦 Packages

All packages are published on npm and ready for production use!

Package	Version	Description
@agentforge/core	0.16.13	Core abstractions (tools, registry, LangGraph utilities, middleware, streaming, resources, monitoring)
@agentforge/patterns	0.16.13	Agent patterns (ReAct, Plan-Execute, Reflection, Multi-Agent)
@agentforge/tools	0.16.13	Standard tool library (81 production-ready tools)
@agentforge/skills	0.16.13	Agent Skills system (SKILL.md discovery, activation, trust policies)
@agentforge/testing	0.16.13	Testing utilities (mocks, assertions, fixtures)
@agentforge/cli	0.16.13	CLI tool (156 tests, 98.11% coverage)

Installation

# Install core package
npm install @agentforge/core

# Install agent patterns
npm install @agentforge/patterns

# Install standard tools
npm install @agentforge/tools

# Install testing utilities (dev dependency)
npm install -D @agentforge/testing

# Install CLI globally
npm install -g @agentforge/cli

🤖 Agent Patterns

AgentForge provides 4 production-ready agent patterns:

1. ReAct (Reasoning and Action)

Think → Act → Observe loop for exploratory tasks

import { createReActAgent } from '@agentforge/patterns';
import { ChatOpenAI } from '@langchain/openai';

const agent = createReActAgent({
  model: new ChatOpenAI({ model: 'gpt-4' }),
  tools: [searchTool, calculatorTool],
  maxIterations: 5
});

2. Plan-Execute

Structured planning with parallel execution

import { createPlanExecuteAgent } from '@agentforge/patterns';

const agent = createPlanExecuteAgent({
  planner: { llm, maxSteps: 5 },
  executor: { tools, parallel: true },
});

3. Reflection

Iterative self-improvement through critique

import { createReflectionAgent } from '@agentforge/patterns';

const agent = createReflectionAgent({
  generator: { llm },
  reflector: { llm },
  maxIterations: 3,
});

4. Multi-Agent

Coordinate specialized agents

import { createMultiAgentSystem, registerWorkers } from '@agentforge/patterns';

const system = createMultiAgentSystem({
  supervisor: { model: llm, strategy: 'skill-based' },
  workers: [],
  aggregator: { model: llm },
});

registerWorkers(system, [
  { name: 'tech_support', capabilities: ['technical'], tools: [...] },
  { name: 'billing_support', capabilities: ['billing'], tools: [...] },
]);

See the Pattern Comparison Guide to choose the right pattern.

🔌 Middleware System

AgentForge provides a powerful middleware system for adding cross-cutting concerns to your LangGraph nodes:

Built-in Middleware

Caching - TTL-based caching with LRU eviction
Rate Limiting - Token bucket, sliding window, and fixed window strategies
Validation - Zod schema validation for inputs and outputs
Concurrency Control - Semaphore-based concurrency limiting
Logging - Structured logging with customizable levels
Retry - Exponential backoff retry logic
Error Handling - Graceful error handling with fallbacks
Timeout - Execution timeouts for long-running operations
Metrics - Performance metrics collection
Tracing - Distributed tracing support

Quick Example

import { compose, withCache, withValidation, withRateLimit } from '@agentforge/core';
import { z } from 'zod';

const schema = z.object({ query: z.string() }).strict();

const enhancedNode = compose(
  withValidation({ inputSchema: schema }),
  withCache({ ttl: 3600000 }),
  withRateLimit({ maxRequests: 100, windowMs: 60000 }),
  myNode
);

Production Presets

import { production } from '@agentforge/core';

const productionNode = productionPreset(myNode, {
  cache: { ttl: 3600000 },
  rateLimit: { maxRequests: 100, windowMs: 60000 },
  retry: { maxAttempts: 3 },
});

See the Middleware Guide for comprehensive documentation.

🚀 Quick Start

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run tests
pnpm test

# Run tests with coverage
pnpm test:coverage

📖 Documentation

🌐 User Documentation (GitHub Pages)

🚀 Quick Start - Get started in 5 minutes
📚 Full Documentation - Complete guides and API reference
🤖 Pattern Guides - ReAct, Plan-Execute, Reflection, Multi-Agent
🔧 Middleware Guide - Comprehensive middleware guide
💡 Examples - Working code examples
📖 API Reference - Complete API documentation

📂 Developer Documentation (Repository)

For contributors and advanced users:

Framework Design - Architecture and design decisions
Roadmap - Development roadmap and milestones
Monorepo Setup - Monorepo structure and setup
Codebase Learning Guide - Contributor onboarding
Logging Standards - Internal logging standards
Pattern Comparison - Detailed pattern comparison

Examples & Templates

🚀 Deployment Templates

Production-ready templates for deploying your agents:

Docker Templates - Containerization with docker-compose
Kubernetes Manifests - Production K8s deployment
CI/CD Pipelines - GitHub Actions & GitLab CI
Cloud Guides - AWS, GCP, Azure deployment guides

💡 Application Examples

Real-world applications and integrations:

Research Assistant - ReAct pattern for research
Code Reviewer - Reflection pattern for code quality
Data Analyst - Plan-Execute pattern for data analysis
Customer Support Bot - Multi-Agent pattern for support
Express.js Integration - REST API with streaming
Next.js Integration - Full-stack app with chat UI

📚 Pattern Examples

ReAct Examples - 4 ReAct examples
Plan-Execute Examples - 4 Plan-Execute examples
Reflection Examples - 4 Reflection examples
Multi-Agent Examples - 4 Multi-Agent examples

🔧 Feature Examples

Streaming Examples - 5 streaming examples (32+ demonstrations)
Advanced Tools Examples - 4 tool examples
Resource Management Examples - 4 resource examples
Monitoring Examples - 4 monitoring examples
Deployment Examples - 4 deployment examples

🏗️ Development

Prerequisites

Node.js >= 18.0.0
pnpm >= 8.0.0

Setup

# Clone the repository
git clone https://github.com/TVScoundrel/agentforge.git
cd agentforge

# Install dependencies
pnpm install

# Build packages
pnpm build

Available Scripts

pnpm build          # Build all packages
pnpm dev            # Watch mode for all packages
pnpm test           # Run tests
pnpm test:coverage  # Run tests with coverage
pnpm test:ui        # Run tests with UI
pnpm lint           # Lint all packages
pnpm lint:fix       # Lint and fix all packages
pnpm format         # Format all packages
pnpm typecheck      # Type check all packages
pnpm clean          # Clean all build artifacts

🎯 Current Status

🎉 AgentForge v0.16.13 - Published on npm and Production-Ready!

All 7 Phases Complete:

✅ Phase 1: Tool Registry (113 tests)

Rich tool metadata, builder API, registry with events
LangChain integration, prompt generation
Status: Complete & Published

✅ Phase 2: LangGraph Utilities (158 tests)

State management, workflow builders, error handling
Memory & persistence, observability & logging
Status: Complete & Published

✅ Phase 3: Agent Patterns (129 tests)

ReAct, Plan-Execute, Reflection, Multi-Agent patterns
16 working examples with comprehensive documentation
Status: Complete & Published

✅ Phase 4: Middleware System (94 tests)

Composable middleware (caching, rate limiting, validation, concurrency)
Production, development, and testing presets
Status: Complete & Published

✅ Phase 5: Production Features (163 tests)

5.1: Streaming & Real-time (68 tests) - Stream transformers, SSE, WebSocket, progress tracking
5.2: Advanced Tools - Async execution, lifecycle, composition, testing utilities
5.3: Resource Management - Connection pooling, memory management, batch processing, circuit breaker
5.4: Monitoring - Health checks, profiling, alerts, audit logging
5.5: Deployment - Docker, Kubernetes, CI/CD, configuration management
20 working examples demonstrating all features
Status: Complete & Published

✅ Phase 6: Developer Experience

6.1: CLI Tool - 156 tests (98.11% coverage), 13 commands, 4 templates
6.2: Testing Utilities - Mocks, assertions, fixtures, test helpers
6.3: Standard Tools - 74 production-ready tools (web, file, data, utility, agent)
6.4: Documentation Site - 17 pages, comprehensive guides, API docs, tutorials
Status: Complete & Published

✅ Phase 7: Documentation Completion (34 pages, 10,000+ lines)

7.1: Core Concepts - 5 foundational guides
7.2: Pattern Guides - 4 comprehensive pattern guides (2,011 lines)
7.3: Advanced Topics - 4 advanced guides (3,474 lines)
7.4: Additional Tutorials - 3 step-by-step tutorials
7.5: Missing Examples - 2 complete working examples
7.6: Documentation Review & Polish - Quality assurance, link validation, cross-references
Status: Complete & Published

📊 Project Metrics

Total Tests: 2185 passing across all packages
Test Coverage: 98.11% (CLI package)
Documentation: 34 pages, 10,000+ lines
Examples: 30+ files, 2,500+ lines of real-world code
Tools: 74 production-ready tools
Patterns: 4 complete agent patterns
Packages: 5 published on npm

💡 What You Can Build

🤖 Autonomous Agents - ReAct, Plan-Execute, Reflection, Multi-Agent patterns
🌊 Real-time Applications - Streaming with SSE/WebSocket
🔌 Production APIs - Express.js or Next.js integrations
📊 Data Analysis Tools - Research and analytics agents
💬 Customer Support - Multi-agent support systems
🔍 Code Review Tools - Reflection-based quality tools
🚀 Enterprise Deployments - Docker/Kubernetes ready

See ROADMAP.md for complete development history.

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch
Make your changes
Write tests
Submit a pull request

Release Process

For maintainers releasing new versions:

Automated Version Bump:
```
./scripts/release.sh 0.4.2
```
This updates all package.json files, CLI templates, and documentation.
Manual Steps (see release process guide):
- Update docs-site/changelog.md with release notes
- Run pnpm build and pnpm test
- Review changes with git diff
- Commit: git add . && git commit -S -m "chore: Bump version to X.Y.Z"
- Tag: git tag -a vX.Y.Z -m "Release vX.Y.Z"
- Push: git push && git push --tags
Publish to npm:
```
./scripts/publish.sh
```
This publishes all packages in the correct dependency order.

See .ai/RELEASE_PROCESS.md for the complete process.

📄 License

🙏 Acknowledgments

Inspired by DeepAgents
Built on LangGraph
Powered by LangChain

Name		Name	Last commit message	Last commit date
Latest commit History 832 Commits
.github		.github
docs-site		docs-site
docs		docs
examples		examples
packages		packages
planning		planning
scripts		scripts
templates		templates
.gitignore		.gitignore
.pr-body-st-02002.md		.pr-body-st-02002.md
.pr-body-st-02006.md		.pr-body-st-02006.md
.pr-body-st-03001.md		.pr-body-st-03001.md
.prettierrc		.prettierrc
LICENSE		LICENSE
README.md		README.md
eslint.config.js		eslint.config.js
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
tsconfig.json		tsconfig.json
vitest.config.ts		vitest.config.ts
vitest.integration.config.ts		vitest.integration.config.ts
vitest.workspace.ts		vitest.workspace.ts

Folders and files

Latest commit

History

Repository files navigation

AgentForge

✨ Features

✅ Complete & Production-Ready

📦 Packages

Installation

🤖 Agent Patterns

1. ReAct (Reasoning and Action)

2. Plan-Execute

3. Reflection

4. Multi-Agent

🔌 Middleware System

Built-in Middleware

Quick Example

Production Presets

🚀 Quick Start

📖 Documentation

🌐 User Documentation (GitHub Pages)

📂 Developer Documentation (Repository)

Examples & Templates

🚀 Deployment Templates

💡 Application Examples

📚 Pattern Examples

🔧 Feature Examples

🏗️ Development

Prerequisites

Setup

Available Scripts

🎯 Current Status

✅ Phase 1: Tool Registry (113 tests)

✅ Phase 2: LangGraph Utilities (158 tests)

✅ Phase 3: Agent Patterns (129 tests)

✅ Phase 4: Middleware System (94 tests)

✅ Phase 5: Production Features (163 tests)

✅ Phase 6: Developer Experience

✅ Phase 7: Documentation Completion (34 pages, 10,000+ lines)

📊 Project Metrics

💡 What You Can Build

🤝 Contributing

Release Process

📄 License

🙏 Acknowledgments

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 72

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages