Skip to content

The AI-ready Python toolkit that helps you build and ship code faster.

License

Notifications You must be signed in to change notification settings

Teyik0/ultrapyup

Repository files navigation

Ultrapyup

The AI-ready Python toolkit that helps you build and ship code faster.

Ultrapyup is a zero-config Python development framework that provides a robust development experience for your team and your AI integrations. Built on modern Python tooling for lightning-fast performance, it automatically handles project setup, dependency management, and code quality without interrupting your workflow.

CD Status PyPI Version License Python Version

Heavily inspired by Ultracite, but built for the Python ecosystem.

Quick Start

Install and initialize Ultrapyup in your project:

uvx ultrapyup

That's it! Ultrapyup will automatically detect your project structure and set up modern Python tooling with best practices. No configuration required.

Key Features (Coming Soon)

🎯 Zero-Config by Design

Preconfigured rules optimized for Python projects with sensible defaults. Customize when needed, but it works perfectly out of the box.

🛡️ Maximum Code Quality

Enforces strict type checking with ty, code formatting with ruff, and testing best practices by default, catching errors and maintaining consistency before they become problems.

🤖 AI-Friendly

Ensures consistent code style and quality across all team members and AI models, eliminating debates over formatting and reducing code review friction. Supports GitHub Copilot, Cursor, Windsurf, Zed, Claude Code, and OpenAI Codex.

🔧 Intuitive and Robust

Automatically manages dependencies, handles virtual environments, and enforces code quality standards with clear error reporting for issues that need manual attention.

How It Works (Planned)

  • Automatic project detection and intelligent setup
  • Dependency management with blazing-fast uv (Rust-powered)
  • Code formatting with ruff (Rust-powered)
  • Type safety enforced with strict ty rules (Rust-powered)
  • Import organization and cleanup

Why Ultrapyup?

Finally a lightning-fast Python toolkit that ensures you, your team, and your AI agents are writing code in harmony. Stop spending time on tooling configuration and dependency management. Let Ultrapyup handle the mundane so you can focus on building and shipping.

Inspired by the success of Ultracite in the JavaScript ecosystem, Ultrapyup brings the same philosophy to the Python ecosystem.

Development

This project uses uv for dependency management and packaging. To contribute:

# Clone the repository
git clone https://github.com/teyik0/ultrapyup.git
cd ultrapyup

# Install dependencies
uv sync --all-extras --dev

# Setup pre-commit
uv run lefthook install

# Run tests
uv run pytest -n auto tests --cov --cov-report=xml --cov-report=term

# Run code quality checks
uv run ruff check . --fix
uv run ty check .

# Format code
uv run ruff format .

Contributing

We're in early development and welcome contributions! Whether it's:

  • 🐛 Bug reports and fixes
  • 💡 Feature suggestions and implementations
  • 📚 Documentation improvements
  • 🧪 Testing and feedback

Please open an issue or submit a PR. Check our contributing guidelines for more details.


Star this repo if you're excited about faster Python development! Follow the project for updates as we build toward a stable release.

About

The AI-ready Python toolkit that helps you build and ship code faster.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Sponsor this project

 

Packages

No packages published

Contributors 2

  •  
  •  

Languages