Hands-On-AI-Engineering

A curated collection of practical, production-ready AI projects across multiple modalities, including language models, multimodal models, OCR systems, RAG pipelines, and AI agents. Each project is designed to help you learn, experiment, and build real-world AI applications. ## Table of Contents - [ Why This Repository?](#-why-this-repository) - [️ Project Categories](#️-project-categories) - [ Getting Started](#-getting-started) - [ Contributing](#-contributing) - [ License](#-license) --- ## Why This Repository? - **Learn by Doing**: Each project includes complete code, setup instructions, and documentation - **Production-Ready**: Projects follow best practices and are ready to be adapted for real-world use - **Diverse Use Cases**: From RAG systems to multi-agent workflows and specialized applications - **Multiple Model Providers**: Projects use OpenAI, Anthropic, Google, and open-source models - **Active Community**: Regular updates and new project additions --- ## ️ Project Categories ### AI Agents Intelligent ai agents for various automation tasks. - [**Multi-Agent Research Assistant with Memory**](./ai_agents/research_assistant_with_memory) — Planner, Research, Writer, and Critic agents collaborate over a shared [Actian VectorAI DB](https://www.actian.com/databases/vectorai-db/) memory layer. Retrieves cited answers from PDFs, papers, manuals, and transcripts, self-grades them with a Critic feedback loop, and persists findings across sessions. Fully local via Ollama and BGE embeddings. - [**Multi-Agent Financial Analyst**](./ai_agents/multi_agent_financial_analyst) — Team of specialized agents for comprehensive financial analysis. - [**FinAgent**](./ai_agents/finagent) — Financial assistant agent for stock market analysis and insights. - [**Daily AI News Digest**](./ai_agents/daily-news-digest) — Automated daily digest from 92 Karpathy-curated tech blogs delivered to Telegram every morning. MiniMax M2.7 scores articles from the last 24 hours and surfaces the 3 most significant stories. - [**Agentic Form Filler**](./ai_agents/agentic-form-filler) — Agentic form-filling agent using Landing AI for layout parsing and MiniMax M2.7 for multi-turn data gathering. - [**AI Travel Planning Agent**](./ai_agents/ai_travel_planning_agent) — Multi-agent travel planner that turns a single natural language request into a complete trip plan with flights, hotels, and a day-by-day itinerary. - [**Competitive Intelligence Agent**](./ai_agents/competitive_intelligence_agent) — Generates strategic sales battlecards by analyzing competitors through the lens of your own business context. - [**Multi-Agent Research Assistant (AG2)**](./ai_agents/multi_agent_research_assistant_ag2) — Multi-agent research pipeline using AG2 where three specialists collaborate to research any topic and produce a structured report. - [**Self-Reflective Agentic RAG**](./ai_agents/agentic_rag_system) — LangGraph RAG system that grades retrieved context, rewrites the query if needed, and generates an answer only once the context passes validation. - [**Agentic SQL Search**](./ai_agents/agentic_sql_search) — Natural language to SQL agent powered by Gemma 4 that writes, executes, and explains queries against an e-commerce database. - [**Stock Portfolio Analyst**](./ai_agents/stock_portfolio_analyst) — Portfolio analysis agent built with Agno and DeepSeek-V4-Flash. Fetches live market data via YFinance and generates a report covering P&L, concentration risk, and rebalancing recommendations. - [**Eagle Eye**](./ai_agents/eagle_eye) — GitHub PR review agent using OpenClaw and Telegram. Fetches diffs via GitHub MCP, performs structured code review with severity ratings, and posts feedback after user approval. - [**CartMate — AI Customer Support Agent**](./ai_agents/ai_customer_support_agent) — Memory-powered e-commerce support agent built with Mem0 and Mistral Small 4 that remembers customers and picks up conversations where they left off. - [**Multi-Agent Coding Assistant**](./ai_agents/multi_agent_coding_assistant) — Four-stage coding pipeline powered by Mistral Small 4 and LangChain. A Planner, Coder, and Reviewer agent collaborate to produce a polished final implementation. - [**Startup Analyst**](./ai_agents/startup_analyst) — Startup due-diligence agent powered by MiniMax M2.5. Scrapes a company's site with Firecrawl and produces an investment-grade report covering market position, financials, team, and risks. - [**Research Team**](./ai_agents/research_team) — Multi-agent research system powered by MiniMax M2.5. Seek searches the web, Scout navigates internal documents, and a team leader synthesises findings into a structured report. - [**GitHub Intelligence Agent**](./ai_agents/github_intelligence_agent) — GitHub research agent powered by Gemini 3 Flash and GitHub's official MCP server. Ask anything about repos, contributors, issues, or codebases. - [**Smolagents Code Agent**](./ai_agents/smolagents_code_agent) — Agentic task runner powered by Mistral Small 4 and HuggingFace smolagents. Writes and executes Python code at each step using DuckDuckGo and Wikipedia. - [**Agent Discovery Agent**](./ai_agents/agent_discovery_agent) — Searches and compares AI agents across NANDA, MCP, Virtuals Protocol, A2A, and ERC-8004 through a single natural language interface. Powered by Gemini 3 Flash. - [**Cal Scheduling Agent**](./ai_agents/cal_scheduling_agent) — Conversational scheduling assistant that manages Cal.com appointments through natural language. Book, reschedule, cancel, and check availability with automatic timezone handling. - [**Hacker News Newsletter Agent**](./ai_agents/hacker_news_newsletter_agent) — Fetches the 10 latest Hacker News stories, scrapes full article content with Trafilatura, generates a structured HTML newsletter with Gemma 4, and delivers it to your inbox via Gmail SMTP. - [**Hotel Finder Agent**](./ai_agents/hotel_finder_agent) — Conversational hotel search agent powered by qwen3.6-flash via Orq.ai and the Trivago MCP Server. Search by location, dates, guest count, price range, star rating, and amenities. - [**Marketing Strategy Agent**](./ai_agents/marketing_strategy_agent) — Multi-agent marketing campaign generator. A Market Analyst (with Serper web search), Strategy Officer, and Creative Director run sequentially to produce market research, a full strategy, and creative campaign content. Powered by deepseek-v4-flash via Orq.ai. - [**Brand Monitor**](./ai_agents/brand_monitor_agent) — Monitors brand mentions across Web, YouTube, Twitter/X, and LinkedIn in a single run. Scrapingdog collects platform data and DeepSeek V4 Flash produces a structured intelligence brief per channel. - [**AI Debate Agent**](./ai_agents/ai_debate_agent) - Two LLM debaters argue opposing sides of any topic you choose. A judge scores each turn and declares a winner. - [**Browser Automation Agent**](./ai_agents/browser_automation_agent) - Takes a natural language instruction and autonomously navigates the web to complete it using browser-use. - [**Documentation QnA Agent**](./ai_agents/documentation_qna_agent) - Chat with any documentation by URL. Uses Fetch MCP and DeepSeek V4 Flash on NVIDIA NIM. - [**Job Posting Agent**](./ai_agents/job_posting_agent) - Generates tailored job postings from a company name and role using DeepSeek V4 Flash on NVIDIA NIM. - [**LangChain Data Agent**](./ai_agents/langchain_data_agent) - Query the Chinook SQLite database in plain English through a conversational Streamlit chat interface. - [**Travel Planner Agent**](./ai_agents/travel_planner_agent) - AI trip planning assistant covering weather, budget, packing lists, and day-by-day itineraries from a single request. - [**Personal Finance Agent**](./ai_agents/personal_finance_agent) - Upload a bank statement CSV, auto-categorize transactions, and ask natural language questions about your spending. Powered by a LangChain tool-calling agent backed by Orq.ai with SQLite persistence. - [**Offline Medical Agent**](./ai_agents/offline_medical_agent) - Fully offline agentic RAG system for clinical protocol lookup at remote clinics and field hospitals. - [**Customer Query Routing and Resolution Agent**](./ai_agents/customer_query_routing_agent) - Routes incoming support queries to the right department and generates grounded responses using [Actian VectorAI DB](https://www.actian.com/databases/vectorai-db/) as a local persistent memory and retrieval layer. - [**Email Auto Responder**](./ai_agents/email_auto_responder). Reads unread Gmail messages over IMAP, classifies intent with CrewAI agents on GLM-5.1, and drafts professional replies in a Streamlit dashboard. - [**LLM Agri Bot**](./ai_agents/llm_agri_bot). Farming assistant that answers questions on crop health, weather, pests, and planting seasons using a LangChain tool-calling agent powered by Mistral. - [**Grounded Document Agent**](./ai_agents/grounded_document_agent). Ask a long PDF questions and get answers that cite the exact source pages. LlamaParse handles parsing; retrieval and answers run locally on Ollama. - [**Self-Evolving Code Review Agent**](./ai_agents/self_evolving_code_review_agent). Code reviewer that learns team conventions from engineer feedback without retraining the model, using LangGraph and Actian VectorAI DB for persistent memory. - [**TrueForge Web Research Briefer**](./ai_agents/trueforge_web_research_briefer). Web research agent built on the open-source TrueForge harness. Plans the turn, searches the web via MCP, fans out to parallel subagents, and builds a cited one-page brief. - [**Deep Research Assistant**](./ai_agents/deep_research_assistant). Research agent that answers any question with a fully cited response, built on LangChain Deep Agents with the Liner Web Search API for grounding. - [**Devable Research Agent**](./ai_agents/devable_research_agent). Scheduled three-step pipeline that collects AI engineering signals, ranks the best items, and delivers a structured Slack digest. - [**Instagram Post Crew**](./ai_agents/instagram_post_crew). CrewAI pipeline that turns a topic into an Instagram content package: trend analysis, caption variants, an image prompt, and a recommended posting time. ### OCR Extracting structure and meaning from visual data and documents. - [**AI Receipt and Expense Tracker**](./OCR/receipt_expense_tracker) — Extracts structured data from receipt photos and tracks spending in a local SQLite ledger. Powered by Gemma 4 E2B vision via llama-cpp-python. Fully offline after first run. - [**Image-to-Structured-Data Extractor**](./OCR/image_to_structured_data) — Converts images into validated, structured JSON using Mistral Large 3 and Instructor. - [**LaTeX Formula OCR**](./OCR/latex_formula_ocr) — Extracts math formulas from images and PDFs into LaTeX using a local vision-language model. - [**Medical Prescription Digitizer**](./OCR/medical_prescription_digitizer) — Digitizes handwritten or printed prescriptions into structured output using Mistral Large 3, with real-time drug name validation against RxNorm. ### Audio Projects for audio understanding and analysis. - [**Music Explorer**](./audio/music_explorer) — Chat with any audio file or YouTube video using Gemini 3 Flash. Ask for transcriptions, emotion analysis, instrument identification, and timestamp-aware breakdowns. - [**Multilingual Audio Translator**](./audio/multilingual_audio_translator) — Upload or record audio in any language, get it transcribed with faster-whisper, translated via Gemini, and played back as synthesized speech using Kokoro TTS. - [**Customer Support Voice Agent**](./audio/customer_support_voice_agent) — Voice AI agent that answers phone calls for customer support, built with the Telnyx AI Assistant Builder and a FastAPI webhook that injects live context into every call. ### Multimodal Projects combining vision, video, and language m