Agentica
- agent-framework
Agentica is an open-source framework that makes working with AI agents simple and reliable. It helps you integrate structured function calls with Large Language Models (LLMs) without the usual headaches.
About
What is Agentica?
Agentica is an open-source AI framework that integrates structured function calls with Large Language Models (LLMs), built around Typia’s JSON Schema validation. It is designed for developers building reliable agent systems using TypeScript, and runs on Node.js or Bun environments.
How to use Agentica?
Create a new Agentica project with npx agentica@latest start (or yarn/pnpm/bun equivalents), then define an agent in src/index.ts by passing TypeScript types, OpenAPI specs, or custom controllers to the Agentica class. Run the agent with npm run build && npm run start.
Key features of Agentica
- Schema-driven reliability: validates and corrects LLM parameters automatically
- Automatic error correction with iterative feedback loops
- Complex parameter support: union types, nested objects, recursive schemas
- OpenAPI integration: convert existing APIs into agent capabilities
- TypeScript-first developer experience with automatic schema generation
- Model Context Protocol (MCP) support for Claude Desktop, Cursor, and more
Use cases of Agentica
- Build a shopping assistant agent that understands complex product queries
- Create an API-driven customer support bot with validation and auto-correction
- Develop a code generation agent that reliably outputs structured function calls
- Integrate legacy OpenAPI endpoints into a conversational AI system
FAQ from Agentica
Does Agentica require a specific LLM provider?
Agentica supports Model Context Protocol (MCP) integration, allowing seamless use with various LLMs including Claude Desktop and Cursor. The README does not specify other providers.
Can I use Agentica without TypeScript?
Agentica is TypeScript-first; the README shows examples using TypeScript types and Typia. There is no mention of other language support.
Is Agentica free and open-source?
Yes, Agentica is released under the MIT License and is open-source.
What validation does Agentica add over vanilla LLMs?
It provides automatic JSON Schema-driven validation and automatic error correction, handling complex data types (unions, nested objects, recursive) that vanilla LLMs struggle with.
Does Agentica support OpenAPI specifications?
Yes, you can pass an OpenAPI spec directly to an agent’s controllers, and Agentica converts it into tool-calling capabilities.
Details
- Author
- wrtnlabs
- Category
- agent-framework
- Repository
- wrtnlabs/agentica
<p align="center" >
</p>
<h1 align="center">Agentica</h1>
<p align="center">
<a href="https://www.npmjs.com/package/@agentica/core">
</a>
<a href="https://www.npmjs.com/package/@agentica/core">
</a>
<a href="https://opensource.org/licenses/MIT">
</a>
<a href="https://github.com/samchon/typia">
</a>
<a href="https://discord.gg/aMhRmzkqCx">
</a>
</p>
<p align="center">
<strong>Agentic AI Framework specialized in LLM Function Calling</strong>
<br>
<strong>enhanced by TypeScript compiler skills</strong>
</p>
<p align="center">
</p>
---
<h3 align="center">
Homepage // Documentation // Tutorials // Playground
</h3>
---
_Agentica_ is an open-source framework that makes working with AI agents simple and reliable. It helps you integrate structured function calls with Large Language Models (LLMs) without the usual headaches.
Built around Typia's robust JSON Schema validation, Agentica eliminates the common frustrations of building agent systems - no more dealing with unpredictable outputs or complex integration challenges.
🚀 Key Features
- ✅ Schema-Driven Reliability: Automatically validates and corrects parameters from LLMs.
- 🔄 Automatic Error Correction: Feedback loops to iteratively improve output accuracy.
- 📐 Complex Parameter Support: Easily handle union types, nested objects, and recursive schemas.
- 🌐 OpenAPI Integration: Convert existing APIs into powerful agent capabilities effortlessly.
- 👨💻 Exceptional Developer Experience: TypeScript-first approach with automatic schema generation.
- 🛠️Model Context Protocol(MCP) Support: Seamlessly integrate with various LLMs, including Claude Desktop, Cursor, and more.
⚡ Quickstart
Step 1. Setup Agentica project
_For more details, check out the Getting Started guide._
You can create a new Agentica project using the following command:
# npm
npx agentica@latest start
yarn
yarn agentica start
pnpm
pnpx agentica start
bun
bunx agentica start
Step 2. Create your own AI agent
Open src/index.ts and create your own agent.
Agentica accepts TypeScript types and OpenAPI specifications as input. You can use any of the following:
- TypeScript Types: Define your own types and let Agentica generate the OpenAPI spec for you, powered by Typia.
- OpenAPI Specification: Use an existing OpenAPI spec to create an agent. Agentica converts it for tool calling!
- Custom Controllers: Create your own controllers to extend Agentica's functionality.
<!-- eslint-skip -->
import { Agentica } from "@agentica/core";
import typia from "typia";
const agent = new Agentica({
controllers: [
await fetch(
"https://shopping-be.wrtn.ai/editor/swagger.json",
).then(r => r.json()),
typia.llm.application<ShoppingCounselor>(),
typia.llm.application<ShoppingPolicy>(),
typia.llm.application<ShoppingSearchRag>(),
],
});
await agent.conversate("I wanna buy a MacBook Pro");
Step 3. Run your agent
Let's play with your agent!
npm run build
npm run start # 🎉
🌟 Why Choose Agentica?
Traditional LLM frameworks struggle with structured outputs:
| Problem Area | Vanilla LLMs | ✅ Agentica |
| ---------------------- | ------------------- | ----------------------- |
| Parameter Validation | ❌ Poor reliability | ✅ JSON Schema-driven |
| Complex Data Handling | ❌ Struggles | ✅ Robust Typia support |
| Error Correction | ❌ Manual | ✅ Auto-correcting loop |
| Integration Complexity | ❌ High effort | ✅ Seamless OpenAPI |
---
📚 Documentation & Tutorials & Paper
- Getting Started
- Tutorials
- API Reference
- Paper
---
💬 Community & Support
- Discord
---
👐 Contributing
We welcome contributions from the community! Check out our CONTRIBUTING.md to get started.
---
⚖️ License
Agentica is open-source and available under the MIT License.
---
---
<p align="center">
</p>
<div align="center">
Agentica is proudly developed and maintained by Wrtn Technologies.<br>
Empowering developers to build reliable and structured AI agents effortlessly.
</div>
---
