The tiny, zero-boilerplate AI agent framework for developers who just want things to work.
Most AI frameworks are too heavy. Shrimsource is built on a different philosophy: Agents should be simple scripts, not complex architectures.
- ⚡ 0.5kb Core: Smaller than a single tweet.
- 🚀 30-Second Setup: From
npxto your first LLM response in under a minute. - 🔋 Battery Included: 17+ professional templates for SEO, Sales, Code Review, and more.
- 🛠️ Native Efficiency: Built-in
chat(),search(), andstoragetools. No more boilerplate imports.
Build and run your custom AI agent in 3 steps:
npx create-shrimsourceAdd your OpenRouter/OpenAI key to .env:
LLM_API_KEY=sk-or-v1-....npm install && npm run agentShrimsource abstracts the complexity of LLM and Search into simple, intuitive helpers:
import { chat, searchToText } from "shrimsource"
// 1. Search the web
const context = await searchToText("latest AI trends 2024")
// 2. Chat with context
const summary = await chat(`Summarize this: ${context}`)
console.log(summary)| Component | Responsibility |
|---|---|
shrimsource-core |
The lightweight runtime engine (shrimsource npm package). |
create-shrimsource |
CLI tool to instantly generate ready-to-use agents. |
shrimsource-templates |
17+ Production-grade agent blueprints. |
docs |
Comprehensive 10-page developer guide & API reference. |
| Agent | What it does |
|---|---|
| blank-agent | 🏗️ The ultimate starter with Vitest built-in. |
| research-agent | 🔍 Deep company research & market analysis. |
| code-review-agent | 🤖 Automated PR reviews & bug detection. |
| seo-agent | 📈 Keyword research & outline generation. |
Check out the full catalog of 17+ templates.
We love stars ⭐ and contributions! Whether it's adding a new template or fixing a core bug, check out our Contributing Guide to get started.
Made with 🦐 by the ShrimSource community.