An AI-assisted novel writing app that helps authors generate outlines, characters, worldbuilding and chapters, self-hosted with FastAPI, React and PostgreSQL.
- Stars
- 5
- Forks
- 2
- Open issues
- 0
- Last commit
- 3 days ago
What is it?
AI-CMS is a self-hosted content management system for teams that operate several websites. All sites, categories, articles, media and layouts are managed from a single admin interface, instead of installing a separate CMS for each site.
The admin includes a built-in AI assistant for drafting, rewriting and polishing articles, with pluggable providers such as OpenAI-compatible APIs, Anthropic, MiniMax and Ollama. Publishing renders content through Astro into static files, and builds can be scoped to a whole site, a category or a single article. The stack is FastAPI, PostgreSQL, Redis, Celery and MinIO on the backend, with a React and TypeScript admin, deployed via Docker Compose behind nginx.
The project also includes role-based access control, members, a recycle bin, and notifications for publish success or failure.
Key features
- 01Manage multiple sites, categories, articles, media and layouts in one admin
- 02Built-in AI assistant for drafting, rewriting and polishing, with several model providers
- 03Static publishing with Astro at site, category or article scope
- 04HTML templates with versioning and asset dependencies
- 05Role-based access control with members and a recycle bin
- 06Docker Compose deployment behind nginx
Use cases
- Content teams running several brand or regional websites from one backend
- Agencies hosting client sites without installing a heavy CMS for each one
- Publishers who want static output and keep API keys on their own server
Quick start
- 1
Clone the repository
git clone https://github.com/holyxing/ai-cms.git - 2
Enter the project directory and copy the env template
cd ai-cms && cp deploy/.env.example deploy/.env - 3
Start the services with the start script
./scripts/start.sh - 4
Run the database migrations on first run, then open http://localhost/admin
docker compose -f deploy/docker-compose.yml exec api alembic upgrade head
Things to know
- Requires Docker 24+ with Compose v2, about 4GB RAM and 10GB disk.
- Needs several free ports (80, 18888, 18889, 5432, 9000) to run.
- The project is young with only 2 stars and no stated production-readiness; the roadmap lists hardening for public installs as future work.
In collections
Topics
FAQ
- What is ai-cms?
- Self-hosted, AI-assisted CMS for running many sites from one admin, publishing to static Astro sites. AI-CMS is a self-hosted content management system for teams that operate several websites. All sites, categories, articles, media and layouts are managed from a single admin interface, instead of installing a separate CMS for each site.
- Is ai-cms free to use? What license does it have?
- ai-cms is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is ai-cms still maintained?
- Actively maintained. The last commit to ai-cms was on Nov 4, 2026.
- What can I use ai-cms for?
- Content teams running several brand or regional websites from one backend Agencies hosting client sites without installing a heavy CMS for each one Publishers who want static output and keep API keys on their own server
- How do I install ai-cms?
- Clone the repository: git clone https://github.com/holyxing/ai-cms.git Enter the project directory and copy the env template: cd ai-cms && cp deploy/.env.example deploy/.env Start the services with the start script: ./scripts/start.sh Run the database migrations on first run, then open http://localhost/admin: docker compose -f deploy/docker-compose.yml exec api alembic upgrade head
- Where can I get ai-cms?
- The source code and installation instructions are on GitHub: https://github.com/holyxing/ai-cms
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A minimal, accessible, SEO-friendly blog theme built on Astro with TypeScript, Tailwind CSS and Pagefind search.
A lightweight PHP CMS with no database or plugins, built-in SEO and GEO tooling, and an AI writing assistant for shared hosting.
Desktop CMS for Windows, Mac and Linux that builds static websites with a WordPress-like editing interface.
A full-stack TypeScript CMS built on Astro that aims to bring WordPress-style extensibility and admin UX to serverless, with sandboxed plugins.
A flat-file content management system and template engine written in PHP, with no database required.