@gaia-agent/sdk weekly downloads statistics

GAIA Super Agent SDK

🤖 Build GAIA-Benchmark-ready Super AI Agents in seconds, not weeks

Production-ready Super AI agent with 18+ tools and swappable providers Built on AI SDK v6 ToolLoopAgent & ToolSDK.ai with ReAct reasoning Quick Start · Features · GAIA Benchmark · Documentation

✨ Features

🚀 Zero Configuration

Pre-configured agent ready for GAIA benchmarks out of the box

🧠 ReAct Reasoning Pattern

Built-in Reasoning + Acting framework for structured thinking

� Planning & Verification

Multi-step planning + answer verification for complex tasks

�🔧 18+ Built-in Tools

Organized by category with official SDKs (Tavily, Exa, E2B, BrowserUse, Steel)

🔄 Swappable Providers

Easy provider switching for sandbox, browser, search, and memory

🌐 AI-Powered Search

Integrated Tavily and Exa for intelligent web search

🛡️ Secure Sandbox

E2B cloud sandbox with code execution + filesystem operations

🖥️ Browser Automation

Steel, BrowserUse or AWS AgentCore for web interactions

🧠 Agent Memory

Persistent memory with Mem0 or AWS AgentCore

📦 Tree-Shaking Friendly

ESM with granular exports, TypeScript-first

🎯 Why GAIA Agent?

🌟 Our Mission

Empower developers to build world-class Super AI Agents in minutes, not months.

Whether you're creating a production-ready AI assistant for your product or competing in GAIA benchmarks, GAIA Agent provides the enterprise-grade foundation you need.

❌ Traditional Approach

• Days/weeks setting up APIs • Writing tool wrappers manually • Error handling for each service • Figuring out which providers to use • Integration testing headaches

✅ With GAIA Agent

• 3 lines of code to get started • 16 tools ready with official SDKs • GAIA benchmark ready immediately • Swap providers with one line • Production-tested implementations

Time savings: From weeks of infrastructure setup → 3 lines of code

Result: A world-class, production-ready Super Agent that rivals top AI systems

🌟 What is the GAIA Benchmark?

The GAIA Benchmark is a comprehensive evaluation suite designed to test the capabilities of AI agents across a wide range of tasks, including reasoning, search, code execution, and browser automation.

📖 Read more about GAIA →

🚀 Quick Start

Installation

Basic Usage

Environment Setup

Create a .env file:

📖 Complete environment variables guide →

🛠️ Built-in Tools

| Category | Tools | Providers |

| 🧮 Core | calculator, httpRequest | Built-in | | � Planning | planner, verifier | Built-in | | �🔍 Search | tavilySearch, exaSearch, exaGetContents | Tavily (default), Exa | | 🛡️ Sandbox | e2bSandbox, sandockExecute | E2B (default), Sandock | | 🖥️ Browser | steelBrowser, browserUseTool, awsBrowser | Steel (default), BrowserUse, AWS | | 🧠 Memory | mem0Remember, mem0Recall, memoryStore | Mem0 (default), AWS AgentCore |

📖 Full tools documentation → 📖 Provider comparison → 📖 ReAct + Planning guide → ⭐ NEW

🔄 Swap Providers

Switch providers with one line:

Or set via environment variables:

🎯 GAIA Benchmark

Run official GAIA benchmarks with enhanced results tracking:

📚 Wrong Answers Collection

Automatically track and retry failed tasks:

📖 Wrong answers guide → 📖 Resume feature guide → 📖 Benchmark module docs → 📖 GAIA setup guide →

📊 Enhanced Benchmark Results

Benchmark results now include full task details:

Easier to analyze and debug! 🎉

📈 Benchmark Results

Latest benchmark performance across different task categories:

| Benchmark Command | Timestamp | Results | Accuracy | Model | Providers | Details |

| pnpm benchmark | 2025-11-26 08:33 | 22/53 | 41.51% | gpt-4o | Search: tavily, Sandbox: e2b, Browser: steel | View Details | | pnpm benchmark:level1 | 2025-11-27 10:38 | 16/53 | 30.19% | gpt-4o | Search: openai, Sandbox: e2b, Browser: steel, Memory: mem0 | - | | pnpm benchmark:level1 | 2025-12-03 04:12 | 21/53 | 39.62% | Claude Sonnet 4.5 | Search: openai, Sandbox: e2b, Browser: steel, Memory: mem0 | View Details |

📖 See detailed task-by-task results →

Note: Benchmark results are automatically updated after each benchmark run.

🧪 Testing

Run unit tests with Vitest:

📖 Testing guide →

🎯 Advanced Usage

Custom Tools

ToolSDK Integration

Integrate thousands of tools from ToolSDK.ai ecosystem:

📖 ToolSDK Packages →

Extend GAIAAgent Class

📖 Advanced usage guide → 📖 API reference →

📚 Documentation

📖 Guides

• Quick Start Guide - Get started in 5 minutes • ReAct + Planning Guide ⭐ NEW - Enhanced reasoning & planning • Reflection Guide ⭐ NEW - Step-by-step reflection (optional) • Environment Variables - Complete configuration guide • GAIA Benchmark - Requirements, setup, tips • Improving GAIA Scores - Strategies for better performance & self-evolution • Wrong Answers Collection - Error tracking and retry • Provider Comparison - Detailed provider comparison

🔧 Reference

• API Reference - Complete API documentation • Tools Reference - All available tools • Advanced Usage - Extension examples, patterns • Benchmark Module - Modular architecture • Testing Guide - Unit tests with Vitest

🤝 Contributing

This project uses automated NPM publishing. When changes are merged to main:

1. ✅ Tests run automatically 2. 📦 Version bumps to next patch (e.g., 0.1.0 → 0.1.1) 3. 📝 Changelog created in changelog/ 4. 🚀 Published to NPM 5. 🏷️ Git tag created

For manual version bumps (minor/major), see docs/NPM_PUBLISH_SETUP.md.

📄 License

Apache License 2.0

Made with ❤️ for the AI community

Description from the npm listing.