Skip to content

Transform your project requirements into comprehensive, professional deliverables using AI. Generate everything from technical specifications to database schemas, flow diagrams, and implementation guides - all from a simple requirements list.

License

Notifications You must be signed in to change notification settings

sankyn1/ai-project-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ AI Project Generator

Built with Kiro IDE License: MIT Node.js Version React Version PRs Welcome

Transform your project requirements into comprehensive, professional deliverables using AI. Generate everything from technical specifications to database schemas, flow diagrams, and implementation guides - all from a simple requirements list.

AI Project Generator Demo

✨ Features

🎯 Multi-Provider AI Support

  • OpenAI (GPT-4, GPT-3.5 Turbo)
  • Google AI (Gemini Pro, Gemini 2.5 Flash) - FREE TIER AVAILABLE
  • Anthropic (Claude 3 Opus, Sonnet, Haiku)
  • Groq (Llama 2, Mixtral) - FREE & FAST
  • Ollama (Local models) - COMPLETELY FREE
  • Cohere, Hugging Face, Together AI

πŸ“‹ Comprehensive Deliverables

  • πŸ“„ SRS Document - Complete Software Requirements Specification
  • πŸ“Š Flow Diagrams - Interactive Mermaid flowcharts
  • πŸ—„οΈ SQL Schema - Database design with relationships and queries
  • 🎨 Figma Specifications - UI/UX design guidelines with color palettes
  • πŸ› οΈ Tech Stack - Technology recommendations with reasoning
  • πŸ—οΈ Project Structure - Clean Architecture following industry best practices
  • πŸ”— References - Similar projects, tools, and learning resources

πŸ”§ Flexible Input Methods

  • ✏️ Manual Entry - Add requirements one by one
  • πŸ“ File Upload - Excel, Word, CSV, and text files
  • πŸ“ Text Paste - Copy from any source with smart parsing

🎨 Beautiful Visual Output

  • Dual View Mode - Rendered view + raw code
  • Interactive Diagrams - Mermaid flowcharts render visually
  • Color Visualizations - Live color swatches in design specs
  • Syntax Highlighting - Professional code display
  • Export Options - PDF, JSON, SQL, Mermaid files

πŸš€ Quick Start

Prerequisites

  • Node.js 16+
  • npm or yarn
  • API key from any supported AI provider

Installation

# Clone the repository
git clone https://github.com/yourusername/ai-project-generator.git
cd ai-project-generator

# Install dependencies
npm run setup

# Start the application
npm run dev

The app will be available at:

First Time Setup

  1. Open the app at http://localhost:3000
  2. Click "API Config" in the top right
  3. Choose your AI provider:
    • Free options: Google AI, Groq, Ollama
    • Paid options: OpenAI, Anthropic, Together AI
  4. Enter your API key
  5. Start generating!

πŸ”‘ Getting API Keys

Free Options

Google AI (Recommended for beginners)

  1. Go to Google AI Studio
  2. Create a new API key
  3. Free tier includes generous limits

Groq (Fastest free option)

  1. Sign up at Groq Console
  2. Generate an API key
  3. Very fast inference with free tier

Ollama (Completely free, runs locally)

# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Pull a model
ollama pull llama2

Paid Options

OpenAI (Highest quality)

  1. Go to OpenAI API
  2. Create an API key
  3. Add billing information

Anthropic (Claude)

  1. Go to Anthropic Console
  2. Generate an API key
  3. Claude 3 models available

πŸ“– Usage Guide

Basic Workflow

  1. Add Requirements

    • Use manual entry, file upload, or text paste
    • Be specific about features and functionality
    • Include user stories and acceptance criteria
  2. Configure Settings

    • Select project type (Web App, Mobile, API, etc.)
    • Set technology preferences (optional)
    • Choose your AI provider and model
  3. Generate Deliverables

    • Click "Generate Project Deliverables"
    • Wait for AI to create comprehensive documentation
    • Review results in beautiful rendered format
  4. Export and Use

    • Switch between "Rendered" and "Code" views
    • Export as PDF, JSON, SQL, or Mermaid files
    • Copy code directly for implementation

Example Requirements

User authentication with email and password
Dashboard with analytics charts
File upload and management system
Real-time notifications
Mobile responsive design
Payment integration with Stripe
Admin panel for user management

πŸ—οΈ Architecture

Tech Stack

  • Frontend: React 18, Monaco Editor, Lucide Icons
  • Backend: Node.js, Express, Axios
  • AI Integration: Multi-provider support
  • Visualization: Mermaid diagrams, syntax highlighting
  • Export: PDF generation, file downloads

Project Structure

ai-project-generator/
β”œβ”€β”€ client/                 # React frontend
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/     # React components
β”‚   β”‚   β”œβ”€β”€ App.js         # Main application
β”‚   β”‚   └── App.css        # Styles
β”‚   └── package.json
β”œβ”€β”€ server/                 # Node.js backend
β”‚   β”œβ”€β”€ routes/            # API routes
β”‚   β”œβ”€β”€ services/          # Business logic
β”‚   β”‚   β”œβ”€β”€ generators.js  # AI content generation
β”‚   β”‚   β”œβ”€β”€ aiProviders.js # Multi-provider AI client
β”‚   β”‚   └── logger.js      # Logging system
β”‚   β”œβ”€β”€ logs/              # Generated logs
β”‚   └── index.js           # Server entry point
β”œβ”€β”€ docs/                  # Documentation
└── README.md

🀝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

Development Setup

# Fork and clone the repo
git clone https://github.com/yourusername/ai-project-generator.git

# Install dependencies
npm run setup

# Start development servers
npm run dev

# Run tests (when available)
npm test

Ways to Contribute

  • πŸ› Bug Reports - Found an issue? Let us know!
  • πŸ’‘ Feature Requests - Have ideas for improvements?
  • πŸ”§ Code Contributions - Submit pull requests
  • πŸ“š Documentation - Help improve our docs
  • 🎨 Design - UI/UX improvements
  • 🌍 Translations - Help make it accessible globally

πŸ“ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ€– Built with Kiro IDE

This entire project was created using Kiro IDE - an AI-powered development environment that accelerates software development through intelligent code generation, automated testing, and seamless collaboration between developers and AI.

Why Kiro IDE?

  • πŸš€ Rapid Development - Built this comprehensive project in record time
  • 🧠 AI-Powered - Intelligent code suggestions and generation
  • πŸ”§ Full-Stack Support - Seamless frontend and backend development
  • πŸ“ Documentation - Auto-generated docs and README files
  • 🎨 UI/UX Design - AI-assisted component and styling creation
  • πŸ” Code Quality - Built-in linting, formatting, and best practices

"This project showcases the power of AI-assisted development. What traditionally would take weeks to build was accomplished in days using Kiro IDE's intelligent development environment."

Try Kiro IDE: kiro.ai | Learn More: Documentation


πŸ™ Acknowledgments

  • πŸ€– Kiro IDE - The AI development environment that made this project possible
  • OpenAI for GPT models and AI infrastructure
  • Google for Gemini AI and free tier access
  • Anthropic for Claude models
  • Mermaid for beautiful diagram rendering
  • Monaco Editor for professional code editing
  • React and Node.js communities for amazing frameworks

β˜• Support the Project

If this project helped you save time and create amazing deliverables, consider supporting its development!

Buy Me A Coffee

Your support helps:

  • πŸš€ Maintain and improve the project
  • πŸ†• Add new AI providers and features
  • πŸ“š Create better documentation and tutorials
  • πŸ› Fix bugs and improve performance
  • 🌟 Keep the project free and open source

Other ways to support:

  • ⭐ Star this repository on GitHub
  • πŸ› Report bugs and suggest features
  • 🀝 Contribute code or documentation
  • πŸ“’ Share the project with others

πŸ“ž Support & Community

🌟 Star History

Star History Chart


Made with ❀️ by the open source community

Transform your ideas into reality with AI-powered project generation!

About

Transform your project requirements into comprehensive, professional deliverables using AI. Generate everything from technical specifications to database schemas, flow diagrams, and implementation guides - all from a simple requirements list.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

No packages published

Contributors 2

  •  
  •  

Languages