AditthyaSS/iloveAgents

**AI Agents, ready to use. Open source. Community-built. Bring your own key.**
---
Table of Contents
- Repository Highlights
- Feature Comparison
- What is iloveAgents?
- Why iloveAgents?
- Available Agents
- Agent Categories
- Supported Providers
- Battle Mode
- AI Workflow Builder
- Scheduled Automations
- Quick Start
- Getting Started
- Prerequisites
- Run Locally
- Troubleshooting
- Deploy Your Own
- How It Works
- Project Structure Overview
- Contributing
- Add a New Agent in 3 Steps
- Other Ways to Help
- Tech Stack
- Frequently Asked Questions
- Community
- License
---
Repository Highlights
- **Open-source and community-driven** — built and run entirely by contributors
- **Supports multiple AI providers** — OpenAI, Anthropic, Google Gemini, and OpenRouter
- **Battle Mode** — compare model responses side by side
- **Workflow Builder** — chain multiple agents into a single automated run
- **Scheduled Automations** — run agents on recurring schedules (hourly/daily/weekly) with encrypted key storage & email alerts
- **Browser-based & Privacy-focused** — BYOK model with direct browser calls or opt-in server-side encryption
- **Extensible architecture** — add new agents easily
- **Contributor-friendly** — active community, easy to get started
---
Feature Comparison
A quick side-by-side look at the platform's core features:
| Feature | Purpose | Requires API Key | Requires Supabase | Supports Multiple Providers |
|---|---|:---:|:---:|:---:|
| Individual Agents | Run a single AI agent | ✅ | ❌ | ✅ |
| Battle Mode | Compare responses from multiple AI providers | ✅ | ❌ | ✅ |
| Workflow Builder | Chain multiple AI agents together | ✅ | ✅ | ✅ |
| Scheduled Automations | Run agents on recurring schedules with email alerts | ✅ | ✅ | ✅ |
---
What is iloveAgents?
iloveAgents is a clean, open source web platform where you can run AI agents directly in your browser.
No sign-up. Core agent runs happen right in your browser — just paste your API key and go. Optional backend features (workflows, automations, email reports) use Supabase and Resend when configured.
Each agent is a focused tool that does one thing really well — summarize meeting notes, review code, generate SQL, write cold emails, and a lot more. The whole platform is config-driven, which means adding a new agent is as simple as adding one JavaScript object to a single file. No deep React knowledge needed.
---
Why iloveAgents?
- **Your API key never leaves your browser.** It goes directly to OpenAI, Anthropic, or Google. No middleman, no storage, no tracking.
- **Zero setup.** No .env files, no backend, no database. Clone and run in under a minute.
- **Works with all major providers.** OpenAI, Anthropic, and Google Gemini — switch between them at runtime.
- **Built for contributors.** Adding a new agent takes about 5 minutes and you don't need to know much React at all.
---
Available Agents
The complete list of agents has been moved to AGENTS.md for better organization and scalability.
---
Agent Categories
The repository contains AI agents for a wide variety of real-world use cases. The table below highlights the major categories available, helping new users quickly discover the project's capabilities.
| Category | Description |
|----------|-------------|
| 🛠️ Engineering | Code generation, debugging, API documentation, testing, DevOps, and software architecture |
| 📚 Education | Study planning, quizzes, flashcards, DSA explanations, and learning resources |
| 📈 Productivity | Meeting notes, email writing, planning, workflows, and personal productivity |
| 📢 Marketing | SEO, blog writing, LinkedIn posts, social media, and content creation |
| 💼 Sales & Business | Lead qualification, proposals, competitive analysis, outreach, and business planning |
| 🎨 Design | UI/UX support, color palettes, typography, image prompts, and creative assets |
| 🏥 Healthcare | Wellness planning, medical summaries, patient documentation, and healthcare assistance |
| 🔬 Research & Data | Research, data science, dataset analysis, and machine learning support |
| 🔐 Security | Cybersecurity analysis, phishing detection, password reviews, and threat intelligence |