hohu 0.1.5

A full-stack project management CLI tool for Hohu Admin ecosystem.

HoHu CLI

A modern full-stack development toolkit for the hohu-admin ecosystem.

English · 中文

---

Features

• Blazing Fast — Built on uv for near-instant CLI response times
• Smart Init — Auto-detects and installs dependencies (uv sync / pnpm install)
• Context-Aware — Run commands from any subdirectory via .hohu project config
• i18n — Full Chinese & English support with automatic system language detection
• Polished UX — Rich-formatted output with interactive prompts via Questionary

Quick Start

Install

# uv (recommended)
uv tool install hohu

# pip
pip install hohu

Update

# uv
uv tool upgrade hohu

# pip
pip install --upgrade hohu

Create a Project

hohu create my-project

Select components (Backend / Frontend / App) interactively. Defaults to hohu-admin if no name is given.

Install Dependencies

cd my-project
hohu init

Automatically detects project config and installs all dependencies.

Switch Language

hohu lang

Development Server

hohu dev launches all services in a single terminal with merged, color-coded log output.

hohu dev          # Start all components
hohu dev -o be    # Backend only
hohu dev -s app   # Frontend + Backend, skip App
hohu dev -t mp    # App in WeChat Mini Program mode

Options

Option	Short	Description	Default
--app-target	-t	App runtime: h5 / mp / app	h5
--only	-o	Only start specified components (repeatable)	all
--skip	-s	Skip specified components (repeatable)	none

Component aliases (case-insensitive): be / backend, fe / frontend, app

Log Colors

Prefix	Color	Service
[Backend]	green	FastAPI
[Frontend]	cyan	Vite / pnpm
[App]	yellow	Uni-app

Press Ctrl+C for graceful shutdown — all child processes are terminated cleanly.

Command Reference

Command	Description
hohu create [NAME]	Create project and clone repo templates
hohu init	Install all sub-project dependencies
hohu dev	Start development server
hohu lang	Switch display language (zh / en / auto)
hohu info	View current CLI configuration
hohu --version	Show version
hohu --help	Show help

Project Structure

my-project/
├── .hohu/            # Project config
├── hohu-admin/       # Backend   — FastAPI / uv
├── hohu-admin-web/   # Frontend  — Vue 3 / pnpm
└── hohu-admin-app/   # App       — Uni-app / pnpm

Tech Stack

Layer	Tool
CLI Framework	Typer
Terminal UI	Rich + Questionary
Package Manager	uv
Backend	FastAPI
Frontend	Vue 3
App	Uni-app

Contributing

Issues and Pull Requests are welcome!

1. Fork the repo
2. Create a feature branch: git checkout -b feature/my-feature
3. Commit your changes: git commit -m 'Add my-feature'
4. Push: git push origin feature/my-feature
5. Open a Pull Request

License

MIT