# 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

---

🎯 Why GAIA Agent?

$3

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.

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

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

$3

📖 Read more about GAIA →

---

🚀 Quick Start

$3

``bash
npm install @gaia-agent/sdk ai @ai-sdk/openai zod
`

$3

`typescript
import { createGaiaAgent } from '@gaia-agent/sdk';

// Create the agent - reads from environment variables
const agent = createGaiaAgent();

const result = await agent.generate({
prompt: 'Calculate 15 * 23 and search for the latest AI papers',
});

console.log(result.text);
`

$3

Create a .env file:

`bash


Required

`typescript
import { createGaiaAgent } from '@gaia-agent/sdk';

const agent = createGaiaAgent({
providers: {
search: 'exa', // Use Exa instead of Tavily
sandbox: 'sandock', // Use Sandock instead of E2B
browser: 'browseruse', // Use BrowserUse instead of Steel
},
});
`

Or set via environment variables:

`bash
GAIA_AGENT_SEARCH_PROVIDER=exa
GAIA_AGENT_SANDBOX_PROVIDER=sandock
GAIA_AGENT_BROWSER_PROVIDER=browseruse
`

---

🎯 GAIA Benchmark

Run official GAIA benchmarks with enhanced results tracking:

`bash


Basic benchmark

`bash


1. Run benchmark (auto-creates wrong-answers.json)

`json
{
"taskId": "abc123",
"question": "What year was X founded?",
"level": 2,
"files": ["image.png"],
"answer": "1927",
"expectedAnswer": "1927",
"correct": true,
"durationMs": 5234,
"steps": 3,
"toolsUsed": ["search", "browser"],
"summary": {
"totalToolCalls": 5,
"uniqueTools": ["search", "browser", "calculator"],
"hadError": false
},
"stepDetails": [ / ... / ]
}
`

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:

`bash
pnpm test # Run all tests
pnpm test:watch # Watch mode
pnpm test:coverage # Coverage report
`

📖 Testing guide →

---

🎯 Advanced Usage

$3

`typescript
import { createGaiaAgent, getDefaultTools } from '@gaia-agent/sdk';
import { tool } from 'ai';
import { z } from 'zod';

const agent = createGaiaAgent({
tools: {
...getDefaultTools(),
weatherTool: tool({
description: 'Get weather',
inputSchema: z.object({ city: z.string() }),
execute: async ({ city }) => ({ temp: 72, condition: 'sunny' }),
}),
},
});
`

$3

Integrate thousands of tools from ToolSDK.ai ecosystem:

`typescript
import { createGaiaAgent, getDefaultTools } from '@gaia-agent/sdk';
import { ToolSDKApiClient } from 'toolsdk/api'; // npm install toolsdk

// Initialize ToolSDK client
const toolSDK = new ToolSDKApiClient({ apiKey: process.env.TOOLSDK_AI_API_KEY });

// Load tools from ToolSDK packages
const emailTool = await toolSDK.package('@toolsdk.ai/mcp-send-email', {
RESEND_API_KEY: process.env.RESEND_API_KEY,
}).getAISDKTool("send-email");

const agent = createGaiaAgent({
tools: {
...getDefaultTools(),
emailTool
},
});

const result = await agent.generate({
prompt: 'Help me search for the latest AI news and send it to john@example.com',
});
`

📖 ToolSDK Packages →

$3

`typescript
import { GAIAAgent } from '@gaia-agent/sdk';

class ResearchAgent extends GAIAAgent {
constructor() {
super({
instructions: 'Research assistant specialized in AI papers',
additionalTools: { / custom tools / },
});
}
}
`

📖 Advanced usage guide →
📖 API reference →

---

📚 Documentation

---

🤝 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

---