Practical overview
When it fits
Use Ratel when an agent can access more tools, skills or instructions than it needs for a typical turn, and you want to retrieve capabilities on demand rather than load the entire set up front.
Who it is for
- Developers building AI agents with large or changing sets of tools and skills.
- Teams integrating context retrieval into TypeScript or Python agent applications.
- Builders who want an MCP-based route for exposing context-management functions.
Documented uses
- Search tool and skill catalogs for capabilities relevant to an agent turn.
- Invoke a selected tool by its catalog ID.
- Load relevant skill instructions only when an agent needs them.
- Retrieve agent memory using BM25 or optional semantic and hybrid ranking.
- Reduce irrelevant tool schemas and skill instructions in agent context.
Requirements & limits
The repository is public and licensed under MIT.
- Ratel is a developer integration layer; the documented examples connect its catalog functions to an agent framework rather than providing a standalone agent.
- BM25 is the default; semantic and hybrid ranking are opt-in.
- Semantic indexing and search are asynchronous, and the documented embedding choices are an in-process model or an OpenAI-compatible embedding endpoint.
- The project states that it requires no vector database.
- The repository identifies an MCP server capability in addition to its TypeScript and Python SDKs.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Set up Ratel catalogs in a TypeScript agent
Install the SDK, register a tool and skill, and obtain the catalog functions to connect to an agent framework.
Before you start
- A TypeScript project using pnpm.
- A tool implementation and skill instructions to register.
Steps
Install the package with
pnpm add @ratel-ai/sdk.Create a
ToolCatalogand register tools with their identifiers, descriptions, schemas and execution functions.Create a
SkillCatalogand register skills, including their descriptions, associated tool IDs and instruction bodies.Create the search, invoke and skill-content functions with
searchCapabilitiesTool,invokeToolToolandgetSkillContentToolfor use as agent tools.
Expected outcome
The project has registered tool and skill catalogs and the functions needed to connect catalog search, tool invocation and skill loading to an agent framework.
Guide limitations
- The example documents catalog setup and the functions to connect; it does not describe completing or deploying an agent application.
- The example does not specify a particular agent framework configuration.
Set up Ratel catalogs in a Python agent
Install the Python package, register a tool and skill, and obtain the catalog functions to connect to an agent framework.
Before you start
- A Python project with pip.
- A tool implementation and skill instructions to register.
Steps
Install the package with the command below.
pip install ratel-aiCreate a
ToolCatalogand register anExecutableToolwith its identifier, description, input schema and execution function.Create a
SkillCatalogand register a skill with its description, associated tool IDs and instruction body.Create the search, invoke and skill-content functions with
search_capabilities_tool,invoke_tool_toolandget_skill_content_toolfor use as agent tools.
Expected outcome
The project has registered tool and skill catalogs and the functions needed to connect catalog search, tool invocation and skill loading to an agent framework.
Guide limitations
- The example documents catalog setup and the functions to connect; it does not describe completing or deploying an agent application.
- The example does not specify a particular agent framework configuration.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 9 October 2026
- Original website title
- ratel-ai/ratel · Official homepage title · retained in its source language

