Chaplin

Unleashing the future of AI together - Cortensor Hackathon, 2025

The Specialist Agent Factory | Try Chaplin Live

"Transform any task into an AI-powered solution. Simply describe what you need, and Chaplin creates and deploys a team of specialist agents that collaborate to accomplish the task. You get a ready-to-use Chaplin that you can share or integrate into your projects."

📖 Quick Index

• 🔎 Why?
• 💡 How does it Work?
• 🎥 Demo
• 🔌 API Integration
• 🔧 Technologies
• 💿 Installation
• 🤝 How to Contribute
• 🐞 Report Bug and Errors
• 📧 Contact

🔎 Why?

AI model responses are significantly improved when provided with relevant context to solve a task. However, each task requires a different type of context, and finding a good solution often involves connecting knowledge from different domains. Creating prompts with this level of depth is a laborious and time-consuming process. This is where Chaplin comes in, addressing several key challenges in using LLMs today:

🎯 Lack of quality context
🎯 Inconsistent, generic, or repetitive responses
🎯 Frequent occurrence of hallucinations
🎯 The difficulty and high time-cost of generating quality prompts that are dynamic, personalized, and scalable;
🎯 Integration barriers with other systems

💡 How does it Work?

Chaplin is an AI agent orchestrator that allows you to create and manage specialized teams to solve complex tasks. Each agent acts as an expert in its field, processing information sequentially until the final answer is generated. With a flexible architecture, Chaplins are easy to share, test, and integrate into your projects, making them ideal for a wide range of applications.

🎥 Demo

🔌 API Integration

How to Integrate with the Chaplin API

1. Find your Chaplin ID: After creating or selecting a Chaplin in the web interface, click the API button. This will reveal your unique chaplin_id.
2. View Examples: In the same popup, you will find code examples for Python, JavaScript, and cURL (CLI) to get you started quickly.
3. The body of your request must be a JSON object containing two keys:

{
  "chaplin_id": "YOUR_CHAPLIN_ID_HERE",
  "input": "Your text or prompt here"
}

Live Integration Example

You can find a demo project that uses the Chaplin API in the /examples/web3museum directory.

• View the Web3Museum live demo - click here

🔧 Technologies

Click to view the full tech stack 🧰

• Frontend: JavaScript, React, Tailwind CSS
• Backend: Vercel Functions, Cloudflare Workers
• Database & Infrastructure: Firebase, Upstash (QStash), ImgBB
• Authentication: Clerk
• IA: LLM (via Cortensor e Gemini)
• Blockchain: Alchemy, Cortensor

💿 Installation

Step 1 - ✅ Requirements

Before you begin, make sure you have installed:

• Node.js - click here
• Vercel CLI - click here

And have an account on the following platforms:

• Firebase - click here,
• Cloudflare - click here,
• Alchemy - click here,
• ImgBB - click here
• Upstash click here.

Step 2 - 🔑 Environment Configuration

• Rename the .env.example files to .env in the following folders:

  /backend
  /web
  /examples/web3museum
  

• Then, open each .env file and fill in the environment variables as indicated in the comments.

⚠️ Remember to remove the { } brackets, using only the values as indicated.

Step 3 - 📦 Install Dependencies

• Inside each of the folders below:

  /backend
  /web
  /examples/web3museum
  

• run the command:

  npm install

Step 4 - 🚀 Running the Project

⚡ Backend - http://localhost:3000

cd backend
vercel dev

💻 Frontend - http://localhost:5173

cd web
npm run dev

🖼️ Example Web3Museum - http://localhost:5174

cd examples/web3museum
npm run dev

🤝 How to Contribute

• Integrate Chaplin with other systems, tools, or applications
• Create New Chaplins for the community - click here
• Check our Roadmap - click here

🐞 Report Bug and Errors

Found a bug or encountered an error? We'd love to help! Here’s how you can get support:

Create a GitHub Issue

• For well-defined bugs, errors, or feature requests, creating an issue is the best way to ensure it gets tracked and addressed by the team.
  ➡️ Create a new issue here

Ask on our Discord

• If you're not sure if it's a bug, have a quick question, or want to discuss the issue first, our community on Discord is the perfect place.
  ➡️ Join the discussion on Discord

📧 Contact

If you have any questions or suggestions, please feel free to contact us. : )

Contact	Luciano Barros
Discord	@lucianofbn
Email	[email protected]
X	@lucianofbn

Contact	Rafael Souza
Discord	@rafaelsouza
Email	[email protected]
X	@rafaelszc

Powered by Lumity💫