The AI-native CMS for running many sites from one admin.
Write with a built-in AI assistant, manage every site in a single backend, and publish to fast Astro static sites — self-hosted, so your content and your API keys never leave your server.
Built for content teams, multi-brand site operators, and agencies tired of one heavy CMS install per site.
中文说明 · Contributing · Security · License
| Pain | AI-CMS |
|---|---|
| Classic CMS is heavy to operate | Docker Compose, static output, simple ops |
| Headless CMS still needs a front-end team | Built-in layouts + Astro SSG |
| Writing & SEO are slow | AI assist (draft / rewrite / polish) in the admin |
| Multi-brand sites = many backends | One admin, many sites |
Not a hosted SaaS clone — self-hosted, open source, your data & your API keys stay with you.
| AI-CMS | WordPress | Ghost | Strapi | |
|---|---|---|---|---|
| AI writing in the admin | ✅ Built in | Via plugins | Limited | Via plugins |
| Many sites, one admin | ✅ Native | Multisite setup | One site per install | ✗ |
| Static output (SSG) | ✅ Astro | ✗ Dynamic by default | ✗ Dynamic | Headless only |
| Front-end team required | No | No | No | Yes |
| Self-hosted & open source | ✅ Apache-2.0 | ✅ | ✅ | ✅ |
- Multi-site admin — sites, categories, contents, media, layouts
- AI assistant — pluggable providers (OpenAI-compatible, Anthropic, MiniMax, Ollama…)
- Editor — HTML / rich text workflows + AI enhance tools
- Static publish — site / category / article scoped builds
- Notifications — publish success/failure with duration in the bell center
- RBAC — roles, members, recycle bin
The short version (full walkthrough below):
git clone https://github.com/holyxing/ai-cms.git
cd ai-cms
cp deploy/.env.example deploy/.env
./scripts/start.sh # then open http://localhost/admin- Docker 24+ / Compose v2+
- ~4GB RAM, ~10GB disk
- Free ports:
80(nginx),18888(API),18889(admin),5432,9000(or change in env)
git clone https://github.com/holyxing/ai-cms.git
cd ai-cms
cp deploy/.env.example deploy/.envSecrets: leave OPENAI_API_KEY / ANTHROPIC_API_KEY / MINIMAX_API_KEY empty unless you need live LLM calls.
Never commit deploy/.env or any real API keys. See SECURITY.md.
./scripts/start.sh
# equivalent:
# docker compose -f deploy/docker-compose.yml up -ddocker compose -f deploy/docker-compose.yml exec api alembic upgrade headdocker compose -f deploy/docker-compose.yml exec api python3 scripts/seed_demo.py --resetUse the accounts printed by the seed script. Change passwords on any shared host.
| URL | Purpose |
|---|---|
| http://localhost/admin | Admin UI (via nginx) |
| http://localhost:18888/docs | OpenAPI (dev) |
| http://localhost:9001 | MinIO console (local) |
Stop: ./scripts/stop.sh
Tear down containers (keep volumes): ./scripts/stop.sh --down
- Backend: FastAPI, PostgreSQL, Redis, Celery, MinIO
- Admin: Vite, React, TypeScript, Tiptap-oriented editing
- Publish: Astro / layout renderer → static files under site public dir
- Deploy: Docker Compose + nginx
| Doc | Content |
|---|---|
| Product | Positioning & architecture |
| API | REST + auth |
| AI agents | Task design |
| Design system | UI rules (required for UI PRs) |
| Ops guide | Production deploy / HTTPS / backup |
| User handbook | Creator workflows |
Agent notes for coding assistants: AGENTS.md
HTML templates with HY_* tags, versioning, asset deps, and site/category/detail scopes.
Source editing with validation, formatting toolbar, and AI actions (style cleanup, polish, image localization).
Context-aware quick actions for articles, templates, and general chat.
Configure MiniMax / OpenAI / Anthropic / Ollama. API keys stay on your server — never commit them.
More screenshots (login, sites, categories, publish) welcome via PR — drop files under
docs/images/.
- Hardening for public self-host installs
- Richer template gallery
- Better onboarding & English UI coverage
- Optional cloud object storage guides
Track progress in Issues.
See CONTRIBUTING.md and the Code of Conduct.
Security reports: SECURITY.md — do not post API keys in issues.
Copyright 2026 AI-CMS contributors.
Licensed under the Apache License 2.0.




