https://github.com/agentuse/agentuse
🤖 AI agents on autopilot. Any model. Runs local, cron, CI/CD, or Docker.
https://github.com/agentuse/agentuse
agents ai ai-agents ai-tools aiagentframework llm
Last synced: about 1 month ago
JSON representation
🤖 AI agents on autopilot. Any model. Runs local, cron, CI/CD, or Docker.
- Host: GitHub
- URL: https://github.com/agentuse/agentuse
- Owner: agentuse
- License: other
- Created: 2025-08-20T19:54:46.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2026-03-11T00:59:05.000Z (3 months ago)
- Last Synced: 2026-03-11T01:26:29.204Z (3 months ago)
- Topics: agents, ai, ai-agents, ai-tools, aiagentframework, llm
- Language: TypeScript
- Homepage: https://docs.agentuse.io
- Size: 1.92 MB
- Stars: 177
- Watchers: 4
- Forks: 15
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Autonomous Agents That Work Without You
Any model. Works with Claude, GPT, and open-source models.
Run anywhere. Webhooks, built-in cron, CI/CD, Mac, Linux, Windows or Docker.
No SDK required. Define your agent in Markdown.
Quick Start •
Example •
Deploy •
Documentation
## Quick Start
```bash
# Try it now - no install needed
ANTHROPIC_API_KEY=sk-ant-... npx agentuse@latest run https://agentuse.io/hello.agentuse
```
Create `my-agent.agentuse`:
```markdown
---
model: anthropic:claude-sonnet-4-6
---
Generate a daily motivation quote with a tech fact.
Format as JSON with 'quote' and 'fact' fields.
```
Run it:
```bash
agentuse run my-agent.agentuse
```
## Example
A real-world agent with MCP tools:
```yaml
---
model: anthropic:claude-sonnet-4-6
mcpServers:
postgres:
command: npx
args: ["-y", "@modelcontextprotocol/server-postgres"]
requiredEnvVars: [DATABASE_URL]
---
Query the sales table for yesterday's metrics.
Generate an executive summary with trends.
```
## Deploy
**Webhook Server** - Trigger agents via HTTP:
```bash
agentuse serve
curl -X POST http://localhost:12233/run -d '{"agent": "my-agent"}'
```
**Scheduled Agents** - Run on a schedule:
```yaml
---
schedule: "0 9 * * *"
---
```
## Features
### 🤖 Multi-Provider Support
Works with Anthropic (Claude), OpenAI (GPT), and OpenRouter for open source models like GLM and Minimax. Switch models with a single line change.
### 🌐 Webhooks & HTTP API
Trigger agents via HTTP webhooks. Integrate with Zapier, Make, GitHub Actions, or any system that can POST. Supports streaming responses for real-time output.
### ⏰ Cron Scheduling
Schedule agents to run automatically with built-in cron support. Use intervals for sub-daily (`5m`, `2h`) or cron expressions for daily+ (`0 9 * * *`).
### 📝 Markdown-Based Agents
Define agents as `.agentuse` files with YAML frontmatter and plain English instructions. Version control, code review, and collaborate on agents like any other code.
### 🔌 MCP Integration
Connect to any [Model Context Protocol](https://modelcontextprotocol.io) server. Access databases, APIs, file systems, and external services through a standardized tool interface.
### 🎭 Sub-Agents
Compose complex workflows by delegating tasks to specialized child agents. Parent agents can spawn sub-agents with isolated contexts and step limits.
### ⚡ Skills System
Create reusable agent instructions as `SKILL.md` files. Reuse your existing Claude Code skills directly - AgentUse reads from the same `.claude/skills/` directories. List available skills with `agentuse skills`.
### 📊 Session Tracking
Full execution history with message logs, tool call traces, token usage, and timing metrics. Debug and audit agent runs with `agentuse sessions`.
## Install
```bash
npm install -g agentuse
```
Set your API key:
```bash
agentuse auth login
```
## Documentation
Full guides and API reference at **[docs.agentuse.io](https://docs.agentuse.io)**
## Contributing
- [Report bugs](https://github.com/agentuse/agentuse/issues)
- [Share ideas](https://github.com/agentuse/agentuse/discussions)
## License
Apache 2.0