StackSketch — Your AI Systems Architect

"Build complete system architecture in seconds — from vague prompt to optimized deployment."


🧠 What StackSketch Does

StackSketch is an AI-powered platform that transforms messy codebases and documentation into clear, interactive, and secure system architecture diagrams. Whether you’re onboarding engineers, scanning for vulnerabilities, or deploying via CI/CD, StackSketch makes your architecture visible, explainable, and actionable.


🔍 Core Capabilities

  • Diagram from Prompt or Repo
    Instantly generate system diagrams (UML, Sequence, Component, etc.) from natural language or GitHub codebases, rendered live with Mermaid.js.

  • Intelligent Codebase Understanding
    VS Code-style file tree exploration, stack detection, and Gemini-powered chat for questions like “How does auth work?”

  • Security & Compliance Automation
    Real-time scanning with severity rankings and compliance reports (SOC 2, HIPAA, GDPR, FERPA).

  • DevOps Pipeline Integration
    Terraform, Kubernetes, and CI/CD-aware diagramming with one-click deploy recommendations.

  • Enterprise Collaboration
    Role-based permissions, audit logging, live sharing of diagrams/codebases, and support for education and enterprise tenants.


🧱 How We Built It

  • Frontend: Angular 17, Tailwind CSS, GSAP, Mermaid.js
  • Backend: FastAPI, Gemini-1.5, GitHub API, RAG-powered static analysis
  • AI Layer: Hugging Face model fine-tuning (with fallback to Gemini for production-readiness)
  • Architecture: Multi-tenant with enterprise access control and audit trails

🧪 Challenges

One of our biggest hurdles was efficiently training our AI model on a domain-specific dataset using Hugging Face within the limited hackathon window. To ensure we still delivered a demoable product, we:

  • Offloaded training asynchronously post-hackathon window
  • Integrated the Gemini API + Mermaid.js to generate temporary visual diagrams
  • Preserved architectural flexibility so we could plug in the custom-trained model later

This approach allowed us to stay lean, ship fast, and validate product features while building toward full AI integration.


🚀 Business Potential

  • Market: Dev teams (cloud-native & enterprise), onboarding, compliance-driven orgs, CS education
  • Monetization:
    • SaaS: Enterprise plans with dashboard, diagram export, and compliance features
    • Education Tier: Academic access with codebase visualization curriculum
    • Cloud Partner Referrals: Earn when users deploy via AWS, Azure, or GCP
  • Feasibility: Already tested with engineering teams across SaaS, healthtech, and education sectors

🔮 Future Plans

  • Custom AI Model Integration: Deploy our trained Hugging Face model for richer, context-specific diagram suggestions
  • Advanced DevOps Optimization: Intelligent cost reduction and performance tuning across cloud providers
  • Live Code-Diagram Syncing: Auto-update diagrams as engineers code in real-time
  • AI-Powered Compliance Copilot: Real-time policy enforcement tied to industry frameworks
  • AI Architecture Simulation: Explore “what-if” infrastructure changes visually before deploying

🎯 Vision

Become the Figma + Copilot for System Architecture—bringing clarity, compliance, and automation to every codebase on Earth.

Built With

Share this project:

Updates