README
¶
Hanzo Git
Hanzo's self-hosted Git forge — Git hosting, code review, issues, packages, and CI/CD (GitHub-Actions-compatible), IAM-native via hanzo.id OIDC. Runs at git.hanzo.ai.
A white-label fork of Gitea (MIT). Upstream copyright and licensing are preserved in LICENSE; identity is wired to Hanzo IAM rather than local accounts, and the product is branded Hanzo Git.
Build & deploy
One way, like every Hanzo repo: the root hanzo.yml declares the
image and tests; a ~7-line .hanzo/workflows/cicd.yml
imports hanzoai/ci, which builds and pushes
ghcr.io/hanzoai/git on our own runners against git.hanzo.ai. Never build the image locally.
The running service is defined in hanzoai/universe (the git operator App CR):
a single-writer SQLite deployment, config injected via the GIT__<section>__<KEY>
env contract, OIDC login reconciled to hanzo.id.
Development
See docs/development.md for a local environment.
After building, run ./gitd web to start the server, or ./gitd help for
all commands.
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
build
|
|
|
openapi3gen
Package openapi3gen converts Gitea's Swagger 2.0 spec to an OpenAPI 3.0 spec.
|
Package openapi3gen converts Gitea's Swagger 2.0 spec to an OpenAPI 3.0 spec. |
|
Package cmd provides subcommands to the gitd binary - such as "web" or "admin".
|
Package cmd provides subcommands to the gitd binary - such as "web" or "admin". |
|
modules
|
|
|
binding
Package binding is a middleware that provides request data binding and validation for Chi.
|
Package binding is a middleware that provides request data binding and validation for Chi. |
|
cache/chi
Package cache is a middleware that aim to have a transparent interface for a lot of cache implementations
|
Package cache is a middleware that aim to have a transparent interface for a lot of cache implementations |
|
captcha
Package captcha a middleware that provides captcha service for chi.
|
Package captcha a middleware that provides captcha service for chi. |
|
charset/generate
command
|
|
|
log
Package log provides logging capabilities for Gitea.
|
Package log provides logging capabilities for Gitea. |
|
queue
Package queue implements a specialized concurrent queue system for Gitea.
|
Package queue implements a specialized concurrent queue system for Gitea. |
|
session/chi
Package session a middleware that provides the session management of Macaron.
|
Package session a middleware that provides the session management of Macaron. |
|
zstd
Package zstd provides a high-level API for reading and writing zstd-compressed data.
|
Package zstd provides a high-level API for reading and writing zstd-compressed data. |
|
api/actions
GitHub Actions Artifacts v4 protocol messages — plain Go structs, no protobuf.
|
GitHub Actions Artifacts v4 protocol messages — plain Go structs, no protobuf. |
|
api/v1
Package v1 Hanzo Git API
|
Package v1 Hanzo Git API |
|
private
Package private contains all internal routes.
|
Package private contains all internal routes. |
|
services
|
|
|
contexttest
Package contexttest provides utilities for testing Web/API contexts with models.
|
Package contexttest provides utilities for testing Web/API contexts with models. |