corellia-cli 1.0.0

A Python CLI framework for project scaffolding and environment synchronization.

Corellia

Corellia is an opinionated CLI tool for managing Python projects.

It provides a unified workflow to:

• manage Python versions
• create and manage virtual environments
• install and track dependencies
• structure projects consistently
• execute project scripts
• build distributable packages

---

Why Corellia

Python development often requires coordinating multiple tools:

• pyenv
• venv
• pip
• git

Corellia orchestrates them into a single, consistent interface, reducing setup complexity and improving reproducibility.

---

Installation

pipx install corellia

[!WARNING] Corellia is currently in early release.

Prerequisites

• Python 3.12+
• pyenv
• Git (recommended)

Frome source

git clone https://github.com/lorenzo-petrecca/Corellia.git
cd corellia
pipx install -e .

---

Quick Start

Create a project

core create

Install dependencies

core sync

Run scripts

core run <script>

Build a package

core init-build
core build

---

Core Concepts

• Single source of truth → corellia.toml
• Deterministic environments → pinned dependencies
• Categories → package, app, deploy
• Frameworks → optional extensions (e.g. Django)

---

Example Project

[project]
name = "myproject"
version = "0.1.0"
python = "3.12"
category = "package"

[dependencies]
requests = "2.32.3"

[scripts.dev]
command = "python main.py"
mode = "strict"

---

Documentation

Full documentation is available in the /docs directory.

---

Roadmap

• app build support
• deploy workflows
• additional frameworks
• packaging improvements

---

License

This project is licensed under the MIT License.