Skip to content

manuvikash/UnifiedCloud

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

12 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

UnifiedCloud πŸš€

Deploy with Vercel FastAPI React TypeScript

An intelligent cloud infrastructure design platform that transforms natural language descriptions into deployable cloud architectures with visual representation and cost estimates.

🌟 Overview

UnifiedCloud is a revolutionary platform that bridges the gap between infrastructure planning and implementation. Simply describe your application requirements in natural language, and watch as UnifiedCloud generates optimized cloud architectures with interactive visualizations, cost breakdowns, and production-ready Terraform configurations.

πŸŽ₯ Demo Video

UnifiedCloud Demo

Click to watch the full demonstration of UnifiedCloud's capabilities

Key Features

  • πŸ—£οΈ Natural Language Input: Describe your infrastructure needs in plain English
  • 🎀 Voice-to-Text: Powered by Gladia API for seamless voice interaction
  • πŸ“Š Interactive Visualization: Real-time graph representation using ReactFlow
  • πŸ’° Cost Estimation: Detailed monthly cost breakdowns for each component
  • πŸ“ Terraform Export: Generate production-ready Infrastructure as Code
  • πŸ”„ Real-time Updates: Live chat interface with instant architecture updates
  • πŸ—οΈ Multi-Cloud Support: AWS, GCP, and Azure components
  • πŸ“± Responsive Design: Works seamlessly on desktop and mobile

πŸ—οΈ Architecture

UnifiedCloud/
β”œβ”€β”€ frontend/          # React + TypeScript + Vite
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/    # Reusable UI components
β”‚   β”‚   β”œβ”€β”€ pages/         # Main application pages
β”‚   β”‚   β”œβ”€β”€ lib/           # Utilities and services
β”‚   β”‚   └── store/         # State management (Zustand)
β”‚   └── ...
β”œβ”€β”€ backend/           # FastAPI + Python
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ routes/        # API endpoints
β”‚   β”‚   β”œβ”€β”€ services/      # Business logic
β”‚   β”‚   └── models/        # Data models
β”‚   └── ...
└── README.md

πŸš€ Quick Start

Prerequisites

Frontend Setup

# Clone the repository
git clone https://github.com/manuvikash/UnifiedCloud.git
cd UnifiedCloud/frontend

# Install dependencies
npm install

# Create environment file
cp .env.example .env

# Add your API keys to .env
VITE_GLADIA_API_KEY=your_gladia_api_key_here
VITE_BACKEND_URL=http://localhost:8000

# Start development server
npm run dev

Backend Setup

# Navigate to backend directory
cd ../backend

# Create virtual environment
python -m venv venv

# Activate virtual environment
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Create environment file
cp .env.example .env

# Add your API keys to .env
ANTHROPIC_API_KEY=your_anthropic_api_key_here
REDIS_URL=redis://localhost:6379

# Start the server
uvicorn app.main:app --reload --host 0.0.0.0 --port 8000

Access the Application

🎯 Usage

1. Intake Phase

  • Select your product type (Web App, API Service, Mobile Backend, etc.)
  • Choose your preferred tech stack
  • Set priority preferences (Cost, Performance, Security, etc.)

2. Design Phase

  • Describe your infrastructure needs using natural language or voice input
  • Watch as UnifiedCloud generates an interactive architecture diagram
  • Review cost estimates and component descriptions
  • Iterate and refine your design through conversation

3. Export Phase

  • Download your architecture as production-ready Terraform code
  • Deploy directly to your cloud provider
  • Use the generated documentation for team collaboration

πŸ› οΈ Technology Stack

Frontend

  • React 18 - Modern UI library with hooks
  • TypeScript - Type-safe JavaScript
  • Vite - Lightning-fast build tool
  • ReactFlow - Interactive node-based diagrams
  • Tailwind CSS - Utility-first CSS framework
  • shadcn/ui - Beautiful, accessible UI components
  • Zustand - Lightweight state management
  • Gladia API - Real-time speech-to-text

Backend

  • FastAPI - High-performance Python web framework
  • Anthropic Claude - Advanced AI for architecture generation
  • Pydantic - Data validation and serialization
  • Redis - Caching and session management
  • uvicorn - ASGI server for production

Infrastructure

  • Vercel - Frontend deployment and hosting
  • Docker - Containerization for backend services
  • Terraform - Infrastructure as Code generation

πŸ”§ Configuration

Environment Variables

Frontend (.env)

VITE_GLADIA_API_KEY=your_gladia_api_key
VITE_BACKEND_URL=http://localhost:8000
VITE_ENVIRONMENT=development

Backend (.env)

ANTHROPIC_API_KEY=your_anthropic_api_key
REDIS_URL=redis://localhost:6379
CORS_ORIGINS=http://localhost:5173
LOG_LEVEL=INFO

API Keys Setup

  1. Gladia API (Speech-to-Text):

    • Sign up at Gladia
    • Generate an API key
    • Add to frontend .env file
  2. Anthropic API (AI Architecture Generation):

    • Sign up at Anthropic
    • Generate an API key
    • Add to backend .env file

πŸ§ͺ Testing

Frontend Testing

cd frontend
npm run test
npm run test:coverage

Backend Testing

cd backend
pytest
pytest --cov=app tests/

Mock Mode

The application includes a comprehensive mock mode for testing without external APIs:

  • 5 intelligent response scenarios
  • Realistic cost calculations
  • Full feature compatibility

πŸš€ Deployment

Frontend (Vercel)

cd frontend
vercel --prod

Backend (Docker)

cd backend
docker build -t unifiedcloud-backend .
docker run -p 8000:8000 unifiedcloud-backend

πŸ“Š Features Deep Dive

Voice Interface

  • Real-time speech-to-text transcription
  • Visual recording indicators
  • Error handling and fallback options
  • Seamless integration with chat interface

Architecture Visualization

  • Interactive node-based diagrams
  • Hover tooltips with component descriptions
  • Real-time cost calculations
  • Cloud provider color coding
  • Responsive layout with automatic positioning

Cost Management

  • Monthly cost estimates for each component
  • Multiplier support for scaled resources
  • Smart cost formatting (K, M notation)
  • Total cost aggregation with visual indicators

Terraform Generation

  • Production-ready HCL code
  • Multi-cloud provider support
  • Best practices implementation
  • Downloadable configuration files

🀝 Contributing

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

Development Workflow

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Add tests for new functionality
  5. Submit a pull request

Code Style

  • Frontend: ESLint + Prettier
  • Backend: Black + isort
  • Commit messages: Conventional Commits

πŸ“„ License

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

πŸ™ Acknowledgments

  • ReactFlow - For the amazing graph visualization library
  • shadcn/ui - For the beautiful UI components
  • Gladia - For the speech-to-text API
  • Anthropic - For the AI capabilities

πŸ“ž Support


Built with ❀️ by the UnifiedCloud team

🌐 Website β€’ πŸ“š Documentation β€’ πŸ› Report Bug β€’ ✨ Request Feature

About

No description, website, or topics provided.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors