- What is iloveAgents?
- Why iloveAgents?
- Available Agents
- Supported Providers
- Battle Mode
- AI Workflow Builder (New)
- [What you can do](#what-you can-do)
- How sequential execution works
- Navigation
- Getting Started
- How It Works
- Contributing
- Tech Stack
- Community
- License
iloveAgents is a clean, open source web platform where you can run AI agents directly in your browser.
No sign-up. No backend. No data collection. Just paste your API key and go.
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.
- Your API key never leaves your browser. It goes directly to OpenAI, Anthropic, or Google. No middleman, no storage, no tracking.
- Zero setup. No
.envfiles, 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.
34 agents and growing — built by the community. 🚀
| # | Agent | What It Does | Category |
|---|---|---|---|
| 1 | PDF Summarizer | Extracts structured summaries from PDF text with key points and action items | Productivity |
| 2 | Research Agent | Comprehensive research on any topic with configurable depth and format | Research |
| 3 | Cold Email Writer | Generates personalized B2B cold emails with tone and length control | Marketing |
| 4 | Code Reviewer | Senior-level code review with issue detection, scoring, and fix suggestions | Engineering |
| 5 | Resume Screener | Evaluates candidates against job descriptions with visual scorecard output | HR |
| 6 | LinkedIn Post Writer | Creates ready-to-post LinkedIn content with strong hooks and hashtags | Marketing |
| 7 | Meeting Notes Summarizer | Turns raw meeting notes into clean summaries with decisions and action items | Productivity |
| 8 | SQL Query Generator | Converts plain English questions into optimized SQL with explanations | Engineering |
| 9 | Regex Generator | Translates plain English descriptions into tested regex patterns with breakdowns | Engineering |
| 10 | Startup Idea Validator | Analyzes startup ideas with market potential, competition, risks, and viability scoring | Business |
| 11 | ELI5 Explainer | Explains complex topics in plain language at your chosen difficulty level | Education |
| 12 | API Doc Generator | Paste code and get clean, professional API documentation with examples | Engineering |
| 13 | Email Reply Writer | Paste any email and describe how you want to respond. Get a polished reply in seconds | Productivity |
| 14 | Bug Report Generator | Describe a bug in plain English and get a complete structured bug report ready for GitHub or Jira | Engineering |
| 15 | Performance Review Writer | Turn bullet notes about an employee into a structured, fair performance review | HR |
| 16 | Cover Letter Writer | Paste a job description and your background. Get a tailored cover letter that actually sounds like you | HR |
| 17 | Incident Post-Mortem Writer | Turn rough incident notes into a blameless post-mortem with timeline, root cause, and action items | Engineering |
| 18 | Changelog Generator | Paste git commits or PR titles and get a clean user-facing changelog | Engineering |
| 19 | Unit Test Generator | Paste any function and get complete unit tests with edge cases and failure scenarios | Engineering |
| 20 | Flashcard Generator | Paste any study material and get ready-to-use flashcards in Q&A format for Anki or Quizlet | Education |
| 21 | Invoice Description Generator | Turn rough work notes into polished invoice line items and a project summary | Productivity |
| 22 | Grant Proposal Writer | Describe your project and get a structured grant proposal with problem statement and methodology | Education |
| 23 | Social Media Thread Writer | Turn any topic into a compelling X/Twitter thread with hooks and a strong call to action | Marketing |
| 24 | Privacy Policy Generator | Describe your app and get a comprehensive privacy policy draft | Legal |
| 25 | Cron Expression Builder | Describe when you want a job to run and get the correct cron expression with explanation | Engineering |
| 26 | Color Palette Generator | Describe a mood or brand and get a complete color palette with hex codes and CSS variables | Design |
| 27 | User Story Writer | Describe a feature and get a well-structured user story with acceptance criteria and edge cases | Product |
| 28 | Persona Generator | Describe your product and get detailed realistic user personas with goals and frustrations | Product |
| 29 | Competitive Analysis Generator | Name your product and competitors and get a structured competitive analysis | Business |
| 30 | Tone Rewriter | Paste any text and get it rewritten in your chosen tone — formal, casual, diplomatic, or concise | Productivity |
| 31 | Data Dictionary Generator | Paste your schema and get a complete data dictionary with field definitions and relationships | Engineering |
| 32 | Accessibility Audit Generator | Paste your HTML and get a detailed WCAG audit with issues, severity ratings, and fixes | Engineering |
| 33 | Personal Budget Analyzer | Analyze monthly income and expenses to get savings rate, benchmarks, and financial recommendations | Finance |
| 34 | K8s Manifest Generator | Generates a full Kubernetes manifest from your app name, container image, port, and optional config | DevOps |
Want to add your own? It takes about 5 minutes. See Contributing below.
| Provider | Logo | Models | Get Your Key |
|---|---|---|---|
| OpenAI |  |
GPT-4o, GPT-4o-mini | platform.openai.com |
| Anthropic |  |
Claude Opus, Claude Sonnet | console.anthropic.com |
| Google Gemini |  |
Gemini 2.5 Flash | aistudio.google.com |
You can switch providers on any agent at runtime from the dropdown. No restart needed.
Pit three AI providers against each other head-to-head.
- Pick any agent from the full registry
- Enter your input once — same prompt goes to all three
- GPT-4o vs Claude Sonnet vs Gemini Flash generate outputs simultaneously
- You pick the winner
Battle Mode has its own dark, dramatic UI with color-coded provider columns (gold for OpenAI, purple for Anthropic, blue for Gemini). Each provider loads independently — if one fails, the other two still work. Access it from the "Enter Battle Mode" button on the homepage or navigate directly to /battle.
Chain multiple agents together and automate your entire process in one run.
Workflows let you connect agents in sequence — the output of each agent automatically becomes the input for the next. Build once, run with any input.
- Build a workflow — pick up to 5 agents, arrange them in order, give the workflow a title
- Run it in one click — paste your input once, every step runs automatically in sequence
- Watch it execute — each step shows its own live status: waiting → running → done / failed
- Chain any agents — research → summarize → write LinkedIn post → done
- Community library — browse and run workflows shared by other users
- Real-time counters — usage counts update live as others run the same workflows
- Share workflows — one-click URL copy on any workflow detail page
Your Input
│
▼
┌─────────────┐
│ Agent 1 │ e.g. Research Agent
└──────┬──────┘
│ output
▼
┌─────────────┐
│ Agent 2 │ e.g. PDF Summarizer
└──────┬──────┘
│ output
▼
┌─────────────┐
│ Agent 3 │ e.g. LinkedIn Post Writer
└─────────────┘
│
Final Output
If any step fails, the workflow stops at that step and shows you exactly what went wrong — with a Retry button. On success, you can copy all outputs at once.
| Route | What it does |
|---|---|
/workflows |
Browse community workflow library |
/workflows/build |
Create and save a new workflow |
/workflows/:id |
View full details of a workflow |
/workflows/:id/run |
Run a workflow step-by-step |
- Node.js v18+
- npm or yarn
# Clone the repository
git clone https://github.com/AditthyaSS/iloveAgents.git
cd iloveAgents
# Install dependencies
npm install
# Start the dev server
npm run devOpen http://localhost:5173 in your browser.
No API provider keys are required in a .env file because
they are entered at runtime and never stored anywhere.
However, local development requires a .env.local file
for Supabase features like Workflows.
Create a .env.local file in the root directory:
VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_keyNote: AI provider API keys are still entered at runtime and are never stored anywhere.
However, local development may still require the following Supabase environment variables:
VITE_SUPABASE_URL=...
VITE_SUPABASE_ANON_KEY=...- Fork this repository
- Import to Vercel or any static host
- Deploy — zero configuration needed
The included vercel.json handles SPA routing automatically.
src/
├── agents/
│ ├── definitions/ # Each agent in its own file (auto-collected)
│ │ ├── pdf-summarizer.js
│ │ ├── code-reviewer.js
│ │ └── ... (33 files)
│ ├── categories.js # CATEGORIES constant
│ └── registry.js # Auto-collects all definitions via import.meta.glob
├── components/
│ ├── AgentRunner.jsx # Generic agent execution UI
│ ├── AgentCard.jsx # Agent card for the homepage grid
│ ├── ApiKeyBar.jsx # Provider and API key input
│ ├── OutputRenderer.jsx # Renders markdown/text/JSON output
│ ├── ScorecardOutput.jsx # Visual scorecard for JSON output
│ ├── BattleNavbar.jsx # Battle Mode navigation bar
│ ├── Navbar.jsx # Top navigation
│ ├── Sidebar.jsx # Agent sidebar
│ └── ...
├── hooks/
│ └── useWorkflows.js # Workflow data operations (fetch, save, realtime)
├── lib/
│ ├── llmAdapter.js # Unified API adapter for all providers
│ ├── supabase.js # Realtime data client
│ └── useApiKey.js # API key state management
├── pages/
│ ├── HomePage.jsx # Landing page with agent grid
│ ├── AgentPage.jsx # Individual agent page
│ ├── WorkflowLibrary.jsx # 🆕 Public workflow library with live counters
│ ├── WorkflowBuilder.jsx # 🆕 Drag-and-drop agent chain builder
│ ├── WorkflowDetail.jsx # 🆕 Single workflow view with realtime stats
│ ├── WorkflowRunner.jsx # 🆕 Sequential agent execution engine
│ ├── BattleModeLanding.jsx # Battle Mode entry page
│ ├── BattleModeSetup.jsx # Battle configuration
│ ├── BattleModeArena.jsx # Three-column battle arena
│ └── BattleModeWinner.jsx # Winner announcement
└── main.jsx
- Registry — Each agent is its own file in
src/agents/definitions/. The registry auto-collects them viaimport.meta.glob— just drop a file in and it appears. - LLM Adapter — A single
runAgent()function inllmAdapter.jshandles all three providers through one unified interface. - Agent Runner —
AgentRunner.jsxbuilds the input form from the config, constructs the prompt, and renders the response. - Battle Mode —
BattleModeArena.jsxfires the same prompt to GPT-4o, Claude Sonnet, and Gemini Flash simultaneously and lets you pick the winner. - Workflow Builder —
WorkflowRunner.jsxchains agents sequentially using the samerunAgent()adapter — output of step N becomes input of step N+1, with per-step status cards and real-time usage counters. - No backend — Every API call goes directly from your browser to the provider. Nothing passes through our servers because there are no servers.
iloveAgents is built by the community. Every contribution matters — whether it is a new agent, a bug fix, a UI improvement, or just fixing a typo.
1. Create a new file in src/agents/definitions/ named your-agent-id.js:
export default {
id: 'your-agent-id',
name: 'Your Agent Name',
description: 'One-line description.',
category: 'Category',
icon: 'IconName', // from lucide.dev/icons
provider: 'any', // 'openai' | 'anthropic' | 'gemini' | 'any'
defaultProvider: 'openai',
model: 'gpt-4o',
inputs: [
{
id: 'field_id',
label: 'Field Label',
type: 'textarea', // text | textarea | code | select | multiselect
placeholder: 'Hint text...',
required: true,
},
],
systemPrompt: `Your system prompt here.`,
outputType: 'markdown', // markdown | text | json
}The registry auto-collects it — no need to edit registry.js.
2. Run npm run dev and test your agent with a real API key.
3. Open a PR. That is it!
See CONTRIBUTING.md for the full guide.
- 🐛 Fix a bug
- 🎨 Improve the UI or UX
- ♿ Improve accessibility
- 📝 Improve the docs
- 🧪 Add tests
| Technology | Purpose |
|---|---|
| React 18 | Component framework |
| Vite 6 | Build tool and dev server |
| Tailwind CSS 3 | Styling |
| React Router 6 | Client-side routing |
| Lucide React | Icons |
| react-markdown | Markdown rendering |
| react-syntax-highlighter | Code highlighting |
- Support — stuck on something? Drop a comment on your issue and I will reply within 24 hours
- Hall of Fame — every person who has contributed to iloveAgents
- Maintainers — who runs this project
Licensed under the MIT License — use it, fork it, build on it.
Built with ❤️ by @AditthyaSS and the open source community
⭐ Star this repo if you find it useful — it helps others discover it!