Metadata-Version: 2.3
Name: volt-cli
Version: 0.1.1a1
Summary: An extremely fast template and stack manager for Python projects.
Author: Vishwa Kumaran
Author-email: Vishwa Kumaran <vishwaa33400@gmail.com>
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Framework :: FastAPI
Classifier: Topic :: Software Development :: Code Generators
Requires-Dist: black>=25.9.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: questionary>=2.1.1
Requires-Dist: tomli>=2.3.0
Requires-Dist: tomli-w>=1.2.0
Requires-Dist: typer>=0.19.2
Requires-Dist: alembic>=1.13.0
Requires-Python: >=3.13
Description-Content-Type: text/markdown

# ⚡ Volt

**Volt** is an extremely fast, modern template and stack manager for Python projects. Built for speed and simplicity, it automates the boilerplate so you can focus on building.

## Features

- **Blazing Fast**: Powered by `uv` for instant dependency resolution and environment setup.
- **Modular Stacks**: Currently supports **FastAPI** with best-practice defaults.
- **Interactive**: Beautiful CLI prompts to guide you through project creation.
- **Production Ready**: Generates structured, type-checked, and linted codebases.

## Installation

Volt requires Python 3.13+. We recommend installing it with `uv` for the best experience:

```bash
# Install via uv (Recommended)
uv tool install volt

# Or via pip
pip install volt
```

## Usage

### Create a New Project

Generate a new FastAPI application with a single command:

```bash
volt fastapi create my-app
```

Follow the interactive prompts to configure your stack (database, authentication, etc.).

### Available Stacks

- **FastAPI**: A high-performance, easy-to-learn framework for building APIs.
  - Includes options for SQLAlchemy, Pydantic, and more.

## Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

1. Clone the repository.
2. Install dependencies: `uv sync`
3. Run tests: `pytest`
