hohu 0.1.7

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), auto-installs uv if missing
• 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

About hohu-admin

hohu-admin is an enterprise-grade full-stack admin management platform built for the AI era. It provides a complete set of production-ready backend infrastructure out of the box — user authentication, RBAC permission control, distributed ID generation, database migration, log monitoring, and API documentation — so developers can focus on business innovation instead of repetitive boilerplate.

Highlights

• Async High Performance — Full async pipeline (FastAPI + SQLAlchemy 2.0 async + PostgreSQL)
• Distributed Snowflake ID — Time-ordered, high-performance primary keys with automatic BigInt → string serialization
• RBAC Permission Model — User-Role-Menu based access control with button-level granularity
• Dual Auth Support — OAuth2 form login (Swagger UI) + JSON login (SPA), with Redis token blacklist
• Unified API Response — Consistent {code, message, data} envelope across all endpoints
• Auto Case Conversion — Backend snake_case ↔ Frontend camelCase via Pydantic alias_generator

Projects

Project	Description	Tech Stack
hohu-admin	Backend API	FastAPI, SQLAlchemy 2.0 (async), PostgreSQL, Redis
hohu-admin-web	Admin dashboard	Vue 3, NaiveUI, UnoCSS, Pinia, TypeScript
hohu-admin-app	Mobile app	uni-app, Vue 3, Wot Design Uni, alova

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

Confirm each component (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.

Windows Users: If hohu init fails with EPERM: operation not permitted, symlink, try the following:

1. Enable Developer Mode in Windows Settings: Settings → Update & Security → For developers → Developer Mode. This allows symlink creation without admin privileges.
2. Run your terminal as Administrator.
3. Check your antivirus software (e.g., 360, Huorong) — some may block symlink creation. Try adding the project directory to the exclusion list or temporarily disabling real-time protection.

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