Alfred is a lightweight AI agent that runs as a 24/7 server, providing automation, notifications, and task management through multiple interfaces.
- Multi-provider LLM support: OpenAI, Anthropic, Google, DeepSeek
- Built-in tools: Webhook, Shell command, Todo management
- Multiple interfaces: REST API, Telegram connector, Terminal UI (TUI)
- Scheduled tasks: Cron-based automation
- Persistent storage: SQLite database for conversations, todos, and memories
curl -fsSL https://raw.githubusercontent.com/ataidecarlos/alfred/main/scripts/install.sh | shiwr -useb https://raw.githubusercontent.com/ataidecarlos/alfred/main/scripts/install.ps1 | iexDownload the latest release from GitHub Releases, extract, and follow the instructions in INSTALL.md.
After installation, edit your config file:
- Linux/Mac:
~/.config/alfred/config.toml - Windows:
%APPDATA%\alfred\config.toml
Add your API keys:
[llm]
default_provider = "openai"
[llm.providers.openai]
api_key = "your-api-key-here"
model = "gpt-4o"alfredalfred --tuiLinux/Mac:
~/.local/bin/alfred/scripts/update.shWindows (PowerShell):
& "$env:LOCALAPPDATA\bin\scripts\update.ps1"| Method | Endpoint | Description |
|---|---|---|
| GET | /health |
Health check |
| GET | /api/info |
Server info |
| POST | /api/messages |
Send message to agent |
| GET | /api/todos |
List all todos |
| POST | /api/todos |
Create a todo |
| DELETE | /api/todos/{id} |
Delete a todo |
- INSTALL.md - Detailed installation guide
- UPGRADE.md - Upgrade instructions
- RELEASE.md - Release process
- ROADMAP.md - Upcoming features
| Provider | Model Example | Base URL |
|---|---|---|
| OpenAI | gpt-4o | https://api.openai.com/v1 |
| Anthropic | claude-sonnet-4-20250514 | https://api.anthropic.com |
| gemini-2.0-flash | https://generativelanguage.googleapis.com | |
| DeepSeek | deepseek-v4-flash | https://api.deepseek.com |
git clone https://github.com/ataidecarlos/alfred.git
cd alfred
cargo build --releasecargo testMIT