Skip to content

codebyellalesperance/ai-architect

Repository files navigation

AI Architect - LLM-Powered Roadmap Generator

An advanced AI system that transforms product ideas into detailed, tool-augmented roadmaps with tailored prompts for 64+ AI tools.

Quick Start

1. Set API Key

export ANTHROPIC_API_KEY='your-key-here'

2. Run Web UI

python3 app.py

Then open: http://localhost:8080

3. Or Use CLI

python3 demo.py "Your product idea here"

Features

LLM-Powered: Uses Claude to generate custom roadmaps for ANY idea ✅ Context-Aware: Every output references your specific domain, user, and goal ✅ Fast Tool Routing: Keyword matching algorithm routes tasks instantly ✅ Tailored Prompts: Generates copy-pastable prompts specific to each tool ✅ Beautiful UI: Glassmorphic interface with animated backgrounds

Architecture

  • models.py - Data structures (Tool, Task, Phase, Roadmap)
  • llm.py - LLM abstraction layer (Anthropic Claude)
  • prompt_templates.py - Phase-specific templates for 15+ common tools
  • tool_architect.py - 4-stage pipeline (profile → plan → route → generate)
    • Stage 1: Project Profiler (LLM)
    • Stage 2: Phase Planner (LLM)
    • Stage 3: Phase Categorizer (keyword matching)
    • Stage 4: Tool Router (keyword matching) + Hybrid Prompt Generator (templates + LLM fallback)
  • app.py - Flask web interface
  • demo.py - CLI interface
  • tool_knowledge_base.json - Registry of 64 AI tools

Requirements

pip install -r requirements.txt

Dependencies:

  • anthropic (Claude API)
  • flask (web UI)
  • fpdf (PDF export)
  • python-docx (DOCX export)

Performance

Current (Optimized):

  • Generation time: ~8-15 seconds (was ~90 seconds)
  • Cost per roadmap: ~$0.01-$0.03 (was ~$0.15-$0.30)
  • LLM calls: ~5-15 (2 planning + 3-13 prompts for niche tools)
  • Template coverage: 85-95% of prompts use instant templates

Optimizations:

  • ✅ Keyword matching for tool routing (eliminated 28 LLM calls)
  • ✅ Phase-specific templates for 50+ common tools (instant generation)
  • ✅ Claude Haiku for prompt generation (10x cheaper, 2-3x faster)
  • ✅ Parallel LLM calls with asyncio (3-5x speedup)
  • ✅ LLM fallback for specialized/niche tools (maintains quality)

Supported tools with templates (50+):

  • AI Assistants: Claude, ChatGPT, DeepSeek, Perplexity
  • Image Gen: Midjourney, DALL-E, Ideogram, Leonardo, Recraft, Adobe Firefly, Stable Diffusion
  • Code: Cursor, Windsurf, GitHub Copilot, Replit Ghostwriter
  • Design: Figma, Canva, Framer, Gamma
  • Productivity: Notion, Airtable, Notion AI
  • Audio: ElevenLabs, Murf, Suno
  • Video: Runway, Synthesia, HeyGen, Colossyan, Fliki, Pictory, CapCut, Luma, Descript
  • Automation: n8n, Make, Zapier
  • Customer Support: Intercom Fin, Chatbase, Zendesk AI
  • Marketing: HubSpot, Copy.ai, Surfer SEO, Jasper, Grammarly
  • No-code: Replit, Bubble, Spline
  • Meetings: Otter.ai
  • And more...

About

AI-Architect instantly turns any idea into a fully-scoped, tool-assigned, build-ready roadmap using a team of specialized agents.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors