docs: Gitea PyPI install paths and publish automation
Some checks failed
ci / test (3.10) (push) Has been cancelled
ci / test (3.12) (push) Has been cancelled

Add make package-check/publish-gitea, tag-triggered Gitea Actions workflow,
PACKAGE_RELEASE.md, and update README/GETTING_STARTED install instructions
for the Coulomb registry (v1.1.0+).
This commit is contained in:
2026-06-16 02:17:30 +02:00
parent 68555ec2f1
commit c9a3a77fdf
6 changed files with 182 additions and 23 deletions

View File

@@ -57,16 +57,22 @@ make install-global
# CLI available from any directory
```
**Option D: From PyPI (Coming Soon)**
**Option D: From Gitea PyPI (v1.1.0+)**
```bash
# Will be available once v1.0.0 is published
pip install kaizen-agentic
# or
pipx install kaizen-agentic # Recommended for global CLI tools
export GITEA_PACKAGE_USER=<gitea-user>
export GITEA_PACKAGE_TOKEN=<package-token>
pip install kaizen-agentic \
--extra-index-url "https://${GITEA_PACKAGE_USER}:${GITEA_PACKAGE_TOKEN}@gitea.coulomb.social/api/packages/coulomb/pypi/simple/"
# or global CLI via pipx
pipx install kaizen-agentic \
--pip-args="--extra-index-url https://${GITEA_PACKAGE_USER}:${GITEA_PACKAGE_TOKEN}@gitea.coulomb.social/api/packages/coulomb/pypi/simple/"
```
> **📦 Release Status**: v1.0.0 is ready for publication. Use `make install-global` for system-wide availability.
> **📦 Registry**: Published on the Coulomb Gitea PyPI registry. Dependencies resolve
> from public PyPI via `--extra-index-url`. See [PACKAGE_RELEASE.md](PACKAGE_RELEASE.md).
### 2. Verify Installation
@@ -265,7 +271,9 @@ jobs:
- uses: actions/setup-python@v4
with:
python-version: '3.8'
- run: pip install kaizen-agentic
- run: >-
pip install kaizen-agentic
--extra-index-url "https://${{ secrets.GITEA_PACKAGE_USER }}:${{ secrets.GITEA_PACKAGE_TOKEN }}@gitea.coulomb.social/api/packages/coulomb/pypi/simple/"
- run: kaizen-agentic validate
```
@@ -405,7 +413,8 @@ kaizen-agentic status
# New team member setup
git clone project-repo
cd project-repo
pip install kaizen-agentic # or add to requirements
# see Option D for GITEA_PACKAGE_USER / GITEA_PACKAGE_TOKEN and --extra-index-url
pip install kaizen-agentic
kaizen-agentic status # See what agents are used
kaizen-agentic validate # Verify everything works
@@ -419,12 +428,16 @@ cat CLAUDE.md
**"Command not found: kaizen-agentic"**
```bash
# Install the package
pip install kaizen-agentic
# Install from Gitea PyPI (same credentials as Option D)
export GITEA_PACKAGE_USER=<gitea-user>
export GITEA_PACKAGE_TOKEN=<package-token>
pip install kaizen-agentic \
--extra-index-url "https://${GITEA_PACKAGE_USER}:${GITEA_PACKAGE_TOKEN}@gitea.coulomb.social/api/packages/coulomb/pypi/simple/"
# Or if using virtual env:
source .venv/bin/activate
pip install kaizen-agentic
pip install kaizen-agentic \
--extra-index-url "https://${GITEA_PACKAGE_USER}:${GITEA_PACKAGE_TOKEN}@gitea.coulomb.social/api/packages/coulomb/pypi/simple/"
```
**"No agents directory found"**
@@ -463,4 +476,4 @@ Once you have agents installed:
4. **Share with team**: Document which agents your project uses
5. **Contribute back**: Report issues and suggest improvements
The key insight is that **you don't need the Makefile targets to use agents effectively** - the `kaizen-agentic` CLI provides all the functionality you need. The Makefile targets are just convenient shortcuts for projects that have them.
The key insight is that **you don't need the Makefile targets to use agents effectively** - the `kaizen-agentic` CLI provides all the functionality you need. The Makefile targets are just convenient shortcuts for projects that have them.