Skip to content
holyxingPublic

About

AI-CMS: AI-assisted multi-site CMS with Astro static publishing (FastAPI + React)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

AI-CMS

AI-CMS

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

License Stack

AI assistant


Why AI-CMS?

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.

How it compares

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 ✅ ✅ ✅

Features

  • 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

Quick start

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

Requirements

  • Docker 24+ / Compose v2+
  • ~4GB RAM, ~10GB disk
  • Free ports: 80 (nginx), 18888 (API), 18889 (admin), 5432, 9000 (or change in env)

1. Clone & configure

git clone https://github.com/holyxing/ai-cms.git
cd ai-cms
cp deploy/.env.example deploy/.env

Secrets: 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.

2. Start

./scripts/start.sh
# equivalent:
# docker compose -f deploy/docker-compose.yml up -d

3. Migrate DB (first run)

docker compose -f deploy/docker-compose.yml exec api alembic upgrade head

4. Optional demo seed

docker compose -f deploy/docker-compose.yml exec api python3 scripts/seed_demo.py --reset

Use the accounts printed by the seed script. Change passwords on any shared host.

5. Open

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


Tech stack

  • 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

Documentation

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


Screenshots

Layout / template editor

Layout template editor

HTML templates with HY_* tags, versioning, asset deps, and site/category/detail scopes.

Article HTML editor + AI enhance

Article HTML editor

Source editing with validation, formatting toolbar, and AI actions (style cleanup, polish, image localization).

AI assistant

AI assistant

Context-aware quick actions for articles, templates, and general chat.

AI providers (bring your own key)

AI providers settings

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/.


Roadmap (high level)

  • Hardening for public self-host installs
  • Richer template gallery
  • Better onboarding & English UI coverage
  • Optional cloud object storage guides

Track progress in Issues.


Contributing

See CONTRIBUTING.md and the Code of Conduct.

Security reports: SECURITY.md — do not post API keys in issues.


License

Copyright 2026 AI-CMS contributors.
Licensed under the Apache License 2.0.

About

AI-CMS: AI-assisted multi-site CMS with Astro static publishing (FastAPI + React)

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages