v1.0.0

Building from Source (Recommended)

GitFlare is built transparently from source. No pre-compiled code is embedded in this repository.

git clone https://github.com/TheCinderProject/gitflare.git
cd gitflare
python -m venv .venv
source .venv/bin/activate
pip install -e .

Or install directly from the sdist:

pip install https://github.com/TheCinderProject/gitflare/archive/refs/tags/v1.0.0.tar.gz

Pre-built Artifacts

These artifacts are provided for checksum verification only.
While functional, building from source is the recommended and preferred method.
This ensures full transparency — you can inspect every line of code before installation.

Artifact	Description
gitflare-*.tar.gz	Source distribution
gitflare-*.whl	Pre-built wheel (convenience only)
git-credential-gitflare-dist	Credential helper script
sha256sums.txt	SHA-256 checksums for verification

Verify Checksums

sha256sum -c sha256sums.txt

The Cinder Project

Made with intent to make the internet a safer place.

v1.0.0: Production-ready release

• Bump version to 1.0.0
• Fix license format to SPDX (GPL-3.0-only)
• Fix ruff import ordering in ui.py
• All docs finalized and consistent
• Wheel builds clean, ruff + mypy pass

Full Changelog: v0.5.0...v1.0.0

v0.5.0

Building from Source (Recommended)

GitFlare is built transparently from source. No pre-compiled code is embedded in this repository.

git clone https://github.com/TheCinderProject/gitflare.git
cd gitflare
python -m venv .venv
source .venv/bin/activate
pip install -e .

Or install directly from the sdist:

pip install https://github.com/TheCinderProject/gitflare/archive/refs/tags/v0.5.0.tar.gz

Pre-built Artifacts

These artifacts are provided for checksum verification only.
While functional, building from source is the recommended and preferred method.
This ensures full transparency — you can inspect every line of code before installation.

Artifact	Description
gitflare-*.tar.gz	Source distribution
gitflare-*.whl	Pre-built wheel (convenience only)
git-credential-gitflare-dist	Credential helper script
sha256sums.txt	SHA-256 checksums for verification

Verify Checksums

sha256sum -c sha256sums.txt

The Cinder Project

Made with intent to make the internet a safer place.

v0.5.0 — Web UI

• Static SPA served at / with dark theme (Forge & Flux design system)
• GitHub/GitLab style toggle (persisted in localStorage)
• Repo listing with latest commit info, auth badge, branch count
• Repo detail: stats overview, file browser, sidebar panels (branches, tags, commits)
• File browser with per-file last commit message and date
• Breadcrumb navigation
• Syntax highlighting via highlight.js (JS, Python, Bash, JSON, YAML, TOML, Go, Rust, etc.)
• Markdown rendering via marked.js with Raw/Rendered toggle
• README auto-rendered on repo overview
• Binary file detection
• Line numbers for code files
• Geist font + JetBrains Mono
• Material Symbols icons
• Health check moved to GET /health
• All docs updated

Full Changelog: v0.4.0...v0.5.0

v0.4.0

Building from Source (Recommended)

GitFlare is built transparently from source. No pre-compiled code is embedded in this repository.

git clone https://github.com/TheCinderProject/gitflare.git
cd gitflare
python -m venv .venv
source .venv/bin/activate
pip install -e .

Or install directly from the sdist:

pip install https://github.com/TheCinderProject/gitflare/archive/refs/tags/v0.4.0.tar.gz

Pre-built Artifacts

These artifacts are provided for checksum verification only.
While functional, building from source is the recommended and preferred method.
This ensures full transparency — you can inspect every line of code before installation.

Artifact	Description
gitflare-*.tar.gz	Source distribution
gitflare-*.whl	Pre-built wheel (convenience only)
git-credential-gitflare-dist	Credential helper script
sha256sums.txt	SHA-256 checksums for verification

Verify Checksums

sha256sum -c sha256sums.txt

The Cinder Project

Made with intent to make the internet a safer place.

v0.4.0 — Stable core

• Structured logging with RequestLogMiddleware (method, path, status, timing)
• Git hooks support: pre-receive (rejects force push to main/master), post-receive, update
• New repos get default hooks installed automatically
• Branch management API: create/delete branches
• Tags listing API
• Hooks API: list installed hooks, test hooks manually
• Enhanced health check: version, repo count, disk usage stats
• Startup/shutdown lifecycle logging
• All docs updated (SPEC, README, rn.md, RECORDED-CHANGES, docs/)

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Building from Source (Recommended)

GitFlare is built transparently from source. No pre-compiled code is embedded in this repository.

git clone https://github.com/TheCinderProject/gitflare.git
cd gitflare
python -m venv .venv
source .venv/bin/activate
pip install -e .

Or install directly from the sdist:

pip install https://github.com/TheCinderProject/gitflare/archive/refs/tags/v0.3.0.tar.gz

Pre-built Artifacts

These artifacts are provided for checksum verification only.
While functional, building from source is the recommended and preferred method.
This ensures full transparency — you can inspect every line of code before installation.

Artifact	Description
gitflare-*.tar.gz	Source distribution
gitflare-*.whl	Pre-built wheel (convenience only)
git-credential-gitflare-dist	Credential helper script
sha256sums.txt	SHA-256 checksums for verification

Verify Checksums

sha256sum -c sha256sums.txt

The Cinder Project

Made with intent to make the internet a safer place.

Fix admin auth: compare token directly instead of bcrypt (config stores plaintext)

New Contributors

• @SabeeirSharrma made their first contribution in #1

Full Changelog: v0.2.0...v0.3.0

v0.2.0

Building from Source (Recommended)

GitFlare is built transparently from source. No pre-compiled code is embedded in this repository.

git clone https://github.com/TheCinderProject/gitflare.git
cd gitflare
python -m venv .venv
source .venv/bin/activate
pip install -e .

Or install directly from the sdist:

pip install https://github.com/TheCinderProject/gitflare/archive/refs/tags/v0.2.0.tar.gz

Pre-built Artifacts

These artifacts are provided for checksum verification only.
While functional, building from source is the recommended and preferred method.
This ensures full transparency — you can inspect every line of code before installation.

Artifact	Description
gitflare-*.tar.gz	Source distribution
gitflare-*.whl	Pre-built wheel (convenience only)
git-credential-gitflare-dist	Credential helper script
sha256sums.txt	SHA-256 checksums for verification

Verify Checksums

sha256sum -c sha256sums.txt

The Cinder Project

Made with intent to make the internet a safer place.

v0.2: token auth, admin verify, login/logout, release workflow, transparency docs

• Add routes/admin.py with /admin/auth/verify endpoint
• Add token auth enforcement on push (Basic auth → bcrypt verify)
• SSH-only repos return 403 for push over HTTP
• Add gitflare-admin login/logout with keyring + gitconfig
• Add GitHub Actions release workflow (auto pre-release on tag)
• Add Transparency & Installation section to README
• Bump version to 0.2.0

Full Changelog: https://github.com/SabeeirSharrma/GitFlare/commits/v0.2.0

v0.1.0

Release Notes — GitFlare

---

v0.1.0 — First Release

Date: 2026-06-26

GitFlare v0.1 is the initial working release. It provides a self-hosted Git server that handles HTTP clone, fetch, and push — delegating all protocol handling to Git's own http-backend.

What's included

• HTTP Smart Protocol — git clone, git push, git pull over HTTP all work out of the box
• Repo lifecycle — create, list, and delete bare Git repos via the admin CLI
• Token infrastructure — each repo gets a gitflare.json with auth_mode and hashed token storage
• Credential helper — git-credential-gitflare is ready for system keychain integration (activates in v0.2)
• Admin CLI — gitflare-admin for repo and token management

Quick start

pip install -e .
uvicorn gitflare.main:app --port 3000
gitflare-admin repo create myproject
git clone http://localhost:3000/myproject.git

What's next (v0.2)

• Token auth enforcement on HTTP endpoints
• gitflare-admin login / logout commands
• Full credential helper flow with keyring
• HTTP push auth with bcrypt token verification

Known limitations

• No auth enforcement yet — all repos are publicly readable/writable over HTTP
• No SSH support (v0.3)
• No web UI (v1.0)