Uvify UI

A modern web interface for uvify - Turn Python repositories into uv environment oneliners.

Features

• 🚀 Analyze GitHub repositories and local directories
• 📦 Parse dependencies from requirements.txt, pyproject.toml, and setup.py
• 🎯 Generate ready-to-use uv commands
• 📋 Copy commands and download results as JSON
• 🎨 Beautiful, GitIngest-inspired UI

Quick Start

Prerequisites

• Node.js 18+
• Python 3.8+
• uv package manager

Install uv if you haven't already:

curl -LsSf https://astral.sh/uv/install.sh | sh
# or on macOS:
brew install uv

Installation & Running

The easiest way to run both the UI and API servers:

npm start

This will:

1. Install all dependencies (if needed)
2. Start the uvify API server on http://localhost:8000
3. Start the UI development server on http://localhost:5173

Manual Setup

If you prefer to run the servers separately:

1. Install dependencies:

npm install
uv venv
source .venv/bin/activate
uv pip install 'uvify[api]'

2. Start the API server:

npm run start:api

3. In another terminal, start the UI:

npm run start:ui

Usage

1. Enter a GitHub repository URL or username/repo format
2. Click "Analyze" to process the repository
3. View the results showing:
   • Parsed dependencies per file
   • Ready-to-use uv commands
   • Python version requirements
   • Directory structure

Development

Project Structure

uvifyUI/
├── src/
│   ├── components/     # React components
│   ├── services/       # API integration
│   └── types/          # TypeScript types
├── public/             # Static assets
└── start.sh           # Unified start script

Available Scripts

• npm start - Run both UI and API servers
• npm run dev - Run UI development server only
• npm run build - Build for production
• npm run lint - Run ESLint

Environment Variables

Copy .env.example to .env and configure:

VITE_API_URL=http://localhost:8000

Built With

• React + TypeScript
• Vite
• Tailwind CSS
• uvify API backend

License

This project is built on top of uvify. See the uvify repository for license information.