Skip to content

QuantZero/ai-agents

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

66 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Overview

This repository contains independent AI agent projects, each with its own purpose and dependencies. All agents are designed to be simple, focused, and easy to use. It is basically a collection of small, focused AI agents built with Python. Each agent is designed to solve a specific task using modern AI/LLM technologies.

New AI generated full-stack applications are automatically built daily by the Agent Builder 2.0 and added to the ai-built-agents directory.

Multi agent flows will be added soon

Available Agents

See the ai-built-agents README for the complete list.

Daily Task Scheduler

Effortlessly organize and prioritize your daily tasks to boost productivity and reduce stress.

Category: productivity

Date: 2026-01-25

πŸ“– Read the Daily Task Scheduler README

Daily Task Prioritizer

An AI agent that dynamically prioritizes daily tasks based on urgency, importance, and user preferences, helping millions stay organized and stress-free.

Category: productivity

Date: 2026-01-23

πŸ“– Read the Daily Task Prioritizer README

Daily Hydration Coach

Helps users maintain optimal hydration levels throughout the day by providing personalized reminders and tips.

Category: health

Date: 2026-01-22

πŸ“– Read the Daily Hydration Coach README

Parenting Assistant

Helps parents efficiently manage daily tasks and child-related activities, reducing stress and enhancing family well-being.

Category: lifestyle

Date: 2026-01-21

πŸ“– Read the Parenting Assistant README

Home Energy Saver

An intelligent agent that optimizes home energy usage to reduce costs and environmental impact for everyday households.

Category: lifestyle

Date: 2026-01-20

πŸ“– Read the Home Energy Saver README

Personal Safety Advisor

An AI agent that helps individuals stay safe by providing real-time safety alerts and guidance based on their location and context.

Category: safety

Date: 2026-01-19

πŸ“– Read the Personal Safety Advisor README

Daily Expense Optimizer

Empowers users to optimize daily spending and achieve financial goals with ease.

Category: finance

Date: 2026-01-18

πŸ“– Read the Daily Expense Optimizer README

Mental Health Check-In

An AI agent that provides personalized mental health check-ins to help individuals manage stress and emotions daily.

Category: wellbeing

Date: 2026-01-17

πŸ“– Read the Mental Health Check-In README

Disaster Preparedness Planner

An AI agent that helps families and individuals prepare for natural disasters by creating customized readiness plans.

Category: safety

Date: 2026-01-15

πŸ“– Read the Disaster Preparedness Planner README

Home Energy Optimizer

An AI agent that automatically optimizes home energy usage to save money and reduce environmental impact.

Category: lifestyle

Date: 2026-01-14

πŸ“– Read the Home Energy Optimizer README

Nutrition Advisor

Personalized nutrition guidance for healthier eating habits.

Category: health

Date: 2026-01-13

πŸ“– Read the Nutrition Advisor README

Digital Declutterer

Effortlessly organize and optimize digital files and emails to reduce stress and save time.

Category: productivity

Date: 2026-01-12

πŸ“– Read the Digital Declutterer README

Daily Time Optimizer

An AI agent to intelligently structure your day for maximum productivity and balance.

Category: productivity

Date: 2026-01-11

πŸ“– Read the Daily Time Optimizer README

Home Maintenance Scheduler

Effortlessly manage and schedule home maintenance tasks to keep your living space in top condition.

Category: lifestyle

Date: 2026-01-10

πŸ“– Read the Home Maintenance Scheduler README

Job Application Tracker

Streamline your job search with a dynamic agent that organizes, tracks, and optimizes your application process.

Category: career

Date: 2026-01-09

πŸ“– Read the Job Application Tracker README

Sleep Quality Enhancer

An AI agent that optimizes your sleep environment and routines for better rest and recovery.

Category: health

Date: 2026-01-07

πŸ“– Read the Sleep Quality Enhancer README

Daily Commute Optimizer

Optimizes daily commute by providing real-time updates and alternative routes to save time and reduce stress.

Category: productivity

Date: 2026-01-06

πŸ“– Read the Daily Commute Optimizer README

Daily Meal Optimizer

Effortlessly plan nutritious and budget-friendly meals tailored to your dietary needs and preferences.

Category: lifestyle

Date: 2026-01-05

πŸ“– Read the Daily Meal Optimizer README

Social Scheduler

Seamlessly organizes social gatherings, making it easy for everyday people to connect and maintain relationships.

Category: communication

Date: 2026-01-03

πŸ“– Read the Social Scheduler README

Career Pathfinder

Guides individuals in identifying and pursuing optimal career paths based on skills, interests, and market trends.

Category: career

Date: 2026-01-02

πŸ“– Read the Career Pathfinder README

Home Security Advisor

An AI agent that proactively advises homeowners to enhance their home security, reducing risks of burglaries and intrusions.

Category: safety

Date: 2025-12-31

πŸ“– Read the Home Security Advisor README

Grocery Saver

Optimizes grocery shopping and budgeting to reduce waste and save money for everyday families.

Category: lifestyle

Date: 2025-12-30

πŸ“– Read the Grocery Saver README

Daily Energy Manager

A personalized agent that optimizes daily energy levels by recommending activities and rest periods to enhance productivity and well-being.

Category: wellbeing

Date: 2025-12-29

πŸ“– Read the Daily Energy Manager README

Exercise Companion

An adaptive agent that personalizes and optimizes exercise routines for everyday individuals to improve fitness and well-being.

Category: health

Date: 2025-12-28

πŸ“– Read the Exercise Companion README

Medication Manager

An assistant that ensures you never miss a dose and keeps track of medication schedules effortlessly.

Category: health

Date: 2025-12-26

πŸ“– Read the Medication Manager README

Bill Tracker

Effortlessly manage and track all your bills to avoid late fees and stress.

Category: finance

Date: 2025-12-26

πŸ“– Read the Bill Tracker README

πŸš€ MVP Planner Agent

A planning agent that helps refine mobile app MVP ideas into clear, technical, builder-ready specifications. Generates a comprehensive builder prompt for the MVP Builder Agent.

Features:

  • Asks focused clarifying questions
  • Generates structured MVP + technical requirements spec
  • Outputs builder-ready prompt
  • Interactive web UI and CLI

Tech Stack: LangChain, OpenAI API, Streamlit

πŸ“– Read the MVP Planner Agent README

πŸ”¨ MVP Builder Agent

An AI-powered builder that takes builder prompts and generates complete, working prototypes with modern tech stacks, best practices, and production-ready code.

Features:

  • Step-by-step building process
  • Uses GPT-4o for high-quality code generation
  • Generates architecture and implementation plans
  • Creates complete project structures
  • Auto-generates documentation

Tech Stack: LangChain, OpenAI API, Streamlit

πŸ“– Read the MVP Builder Agent README

πŸ“§ Email Agent

A local LLM agent that connects to your IMAP inbox, lists unread emails, and provides intelligent summaries. Built with LangGraph and LangChain, running against a local Ollama model.

Features:

  • Lists the most recent unread email
  • Summarizes emails by IMAP UID
  • Interactive CLI interface
  • Runs entirely locally (no cloud API required)

Tech Stack: LangGraph, LangChain, Ollama, IMAP

πŸ“– Read the Email Agent README

🌐 Scraper Agent

A web scraping tool that uses OpenAI's GPT-4o-mini to generate intelligent, readable summaries of any website. Perfect for quickly understanding what a website is about without wading through navigation menus and clutter.

Features:

  • Smart URL handling (accepts URLs in any format)
  • Content extraction (filters out navigation, headers, scripts)
  • AI-powered summaries with a touch of wit
  • Terminal-friendly output

Tech Stack: OpenAI API, BeautifulSoup, Requests

πŸ“– Read the Scraper Agent README

Getting Started

Each agent is independent and can be set up separately. Navigate to the agent's directory and follow its specific README for detailed setup instructions.

Prerequisites

  • Python 3.12+ (Python 3.13+ for email-agent)
  • uv package manager (recommended) or pip
  • Agent-specific requirements:
    • MVP Planner Agent: OpenAI API key
    • MVP Builder Agent: OpenAI API key (GPT-4o recommended)
    • Email Agent: Ollama running locally with a compatible model
    • Scraper Agent: OpenAI API key

Quick Setup

  1. Clone or navigate to this repository:

    cd ai-projects
  2. Choose an agent and navigate to its directory:

    cd mvp-planner-agent    # or mvp-builder-agent, email-agent, scraper-agent
  3. Install dependencies:

    uv sync

    Or with pip:

    pip install -r requirements.txt
  4. Configure environment variables:

    • Create a .env file in the agent's directory
    • Add the required configuration (see each agent's README)
  5. Run the agent:

    python main.py

Project Structure

ai-agents/
β”œβ”€β”€ mvp-planner-agent/    # MVP planning agent
β”‚   β”œβ”€β”€ main.py           # Main entry point
β”‚   β”œβ”€β”€ ui.py             # Streamlit web UI
β”‚   β”œβ”€β”€ pyproject.toml    # Dependencies
β”‚   β”œβ”€β”€ README.md         # Detailed documentation
β”‚   └── .env              # Configuration (gitignored)
β”‚
β”œβ”€β”€ mvp-builder-agent/    # MVP builder agent
β”‚   β”œβ”€β”€ main.py           # Main entry point
β”‚   β”œβ”€β”€ ui.py             # Streamlit web UI
β”‚   β”œβ”€β”€ pyproject.toml    # Dependencies
β”‚   β”œβ”€β”€ README.md         # Detailed documentation
β”‚   └── .env              # Configuration (gitignored)
β”‚
β”œβ”€β”€ email-agent/          # Email management agent
β”‚   β”œβ”€β”€ main.py           # Main entry point
β”‚   β”œβ”€β”€ pyproject.toml   # Dependencies
β”‚   β”œβ”€β”€ README.md         # Detailed documentation
β”‚   └── .env              # Configuration (gitignored)
β”‚
β”œβ”€β”€ scraper-agent/        # Web scraping agent
β”‚   β”œβ”€β”€ main.py           # Main entry point
β”‚   β”œβ”€β”€ scraper.py        # Scraping utilities
β”‚   β”œβ”€β”€ pyproject.toml    # Dependencies
β”‚   β”œβ”€β”€ README.md         # Detailed documentation
β”‚   └── .env              # Configuration (gitignored)
β”‚
└── README.md             # This file

Common Patterns

All agents in this repository follow similar patterns:

  • Configuration: Environment variables via .env files
  • Dependencies: Managed with pyproject.toml and uv
  • CLI Interface: Simple, interactive command-line interfaces
  • Error Handling: Clear error messages and debugging information
  • Documentation: Each agent has its own comprehensive README

Adding New Agents

When adding a new agent to this repository:

  1. Create a new directory with a descriptive name (e.g., new-agent/)
  2. Include a README.md with:
    • Description and features
    • Installation instructions
    • Configuration requirements
    • Usage examples
  3. Use pyproject.toml for dependency management
  4. Add a .env.example file if environment variables are needed
  5. Follow the existing code structure and patterns

Contributing

Each agent is designed to be independent and self-contained. Feel free to:

  • Improve existing agents
  • Add new agents
  • Fix bugs
  • Enhance documentation

License

Each agent may have its own license. Check individual agent directories for license information.

Notes

  • All .env files are gitignored for security
  • Each agent can be used independently
  • Agents are designed to be simple and focused on a single task
  • Local models (like Ollama) are preferred where possible to reduce API costs

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published