Agentage

"Agents should be as simple as writing a README, as portable as a Docker container, and as shareable as an npm package."

---

🎯 Vision

Make AI agents:

• ✅ Simple to create (YAML/Markdown definition)
• ✅ Portable (works everywhere)
• ✅ Shareable (NPM-like registry)
• ✅ Synchronized (cross-platform)

---

📦 Ecosystem

Project	Description	Status
@agentage/sdk	TypeScript SDK with builder pattern
@agentage/cli	NPM-like CLI for managing agents
Desktop	Electron app for visual agent management	🚧 In Progress
Web	Website + Backend API (Next.js + Express + MongoDB)	🚧 In Progress
agentage.io	Registry & platform	🚧 In Progress

---

🚀 Quick Start

SDK (Programmatic)

import { agent, tool } from '@agentage/sdk';

const assistant = agent('assistant')
  .model('gpt-4', { temperature: 0.7 })
  .instructions('You are a helpful assistant')
  .tools([searchTool]);

const result = await assistant.send('Help me with this task');

CLI (Terminal)

# Install
npm install -g @agentage/cli

# Create & run agent
agent init my-assistant
agent run my-assistant "What is TypeScript?"

# Registry commands
agent publish              # Publish to registry
agent install user/agent   # Install from registry
agent search "code review" # Search registry

---

🏗️ Architecture

┌─────────────────────────────────────────────────────┐
│              Desktop App (Electron)                 │
│   React UI → IPC → Embedded CLI Engine              │
└────────────────────────┬────────────────────────────┘
                         │
    ┌────────────────────┼────────────────────┐
    ▼                    ▼                    ▼
┌──────────┐      ┌──────────────┐      ┌──────────┐
│ Registry │      │ GitHub Repos │      │  Local   │
│ API      │      │  (.agent.md) │      │  Files   │
└──────────┘      └──────────────┘      └──────────┘

---

📋 Agent Definition (.agent.md)

---
name: code-reviewer
model: gpt-4
temperature: 0.7
tools:
  - github
---

You are an expert code reviewer.
Review code for bugs, security issues, and best practices.

---

🔗 Links

Resource	URL
Documentation	docs.agentage.io
Registry	agentage.io
SDK Reference	API Docs

---

📄 License

MIT © Agentage