# GEOFlow > Self-hosted GEO content operations: knowledge, AI writing, quality gates and multi-site publishing - Category: AI Productivity & Writing / Writing & Marketing - Language: PHP - Licence: AGPL-3.0 - Repository: https://github.com/yaojingang/GEOFlow - Website: https://www.geoflow.me - Canonical page: https://ai-tldr.dev/tools/geoflow/ - Updated: 2026-09-16 ## In short GEOFlow is an open-source platform for GEO (generative engine optimization) operations on company websites. It sits in the Writing & Marketing category of the AI Productivity & Writing tools and is open-source, written in PHP and licensed AGPL-3.0. To get started: start a local instance with Docker. ## Overview GEOFlow is an open-source platform for GEO (generative engine optimization) operations on company websites. It connects trusted knowledge, AI content production, quality gates, human review, multi-site delivery and analytics in one admin system, so brand, growth and content teams can run an enterprise website, a GEO sub-channel, an industry source site or an internal content operations platform while keeping source material, review decisions, publishing results and operating data together. The workflow runs as a loop: knowledge and assets feed AI content production, an AI quality gate checks each article, a human reviews it, and it is published to the main website, to hosted channel sites, or through a manual publishing desk assisted by a Chrome extension. Traffic and AI visibility analytics then feed back into the knowledge base. The knowledge base supports structured chunking, optional semantic planning and vector recall, and the quality gate scores articles against knowledge evidence, data and citations, advertising rules and publishing context, keeping articles that are pending, blocked or expired in draft. It is a Laravel application backed by PostgreSQL (pgvector recommended) and Redis, deployed with Docker Compose. Published sites automatically serve `robots.txt`, `sitemap.xml`, `sitemap.txt` and `llms.txt`, alongside SEO metadata, Open Graph and Schema output. Distribution channels include hosted sites, a generated GEOFlow Agent PHP package for target sites, WordPress REST and a generic HTTP API. A separate Updater handles signed updates, full backups and restore-point rollback, and an API v1, the `bin/geoflow` CLI and a bundled Agent Skill cover automation. The README is written in Chinese with English, Japanese, Spanish, Russian and Brazilian Portuguese translations, and the admin UI supports six languages. The project is licensed AGPL-3.0 (earlier versions were released under Apache-2.0) and is free for commercial use under those terms; the copyright holder offers a separate commercial license for closed-source integrations that need an exemption from AGPL obligations. ## What it does - Central libraries for knowledge, titles, keywords, images, authors, prompts and AI models, with structured knowledge chunking and vector recall - AI quality gate that checks articles against knowledge evidence, citations, advertising rules and publishing context, recording scores, source locations and suggested fixes - Review workflow for drafts, approval, publishing, trash and batch Markdown export, plus a manual publishing desk that records accounts, assignees, schedules and receipts - Multi-site delivery to hosted channel sites, GEOFlow Agent target sites, WordPress REST and generic HTTP APIs, with automatic sitemaps and `llms.txt` - Data center covering content, distribution, visits, top content, AI crawlers and AI visibility (brand mentions and competitor sources) - Developer entry points: API v1, the `bin/geoflow` CLI and a built-in GEOFlow Agent Skill ## Getting started GEOFlow needs PHP 8.3+, PostgreSQL (pgvector recommended), Redis and Node.js for front-end builds; the quickest route is Docker Compose. For production the project recommends a stable release or a pinned, reviewed commit. 1. Start a local instance with Docker The `init` service runs database migrations and the empty-database install on first start. ```bash git clone https://github.com/yaojingang/GEOFlow.git cd GEOFlow cp .env.example .env docker compose build docker compose up -d --remove-orphans ``` 2. Open the site and the admin The front end defaults to `http://localhost:18080` and the admin to `http://localhost:18080/geo_admin/login`. `APP_PORT` controls the port and `ADMIN_BASE_PATH` the admin prefix; default development admin credentials are in the deployment guide. 3. Deploy for production Production uses `docker-compose.prod.yml` with Nginx and php-fpm. Set an explicit admin password, HTTPS, cookie security and reverse proxy settings first; the full procedure is in `docs/deployment/DEPLOYMENT.md`. ```bash cp .env.prod.example .env.prod docker compose --env-file .env.prod -f docker-compose.prod.yml build docker compose --env-file .env.prod -f docker-compose.prod.yml up -d postgres redis docker compose --env-file .env.prod -f docker-compose.prod.yml up -d init docker compose --env-file .env.prod -f docker-compose.prod.yml up -d --remove-orphans app web queue ai-quality-queue ai-quality-backfill-queue ai-optimization-queue knowledge-queue scheduler reverb ``` 4. Build and test from source For development work on GEOFlow itself. ```bash composer install npm ci npm run build composer test ``` ## When to use it - Run a company website's GEO program, continuously publishing product, case, FAQ and industry content grounded in a knowledge base - Spin up GEO sub-channels or an industry source site on subdomains with SEO metadata, sitemaps and `llms.txt` generated automatically - Give an agency or content team one back office to produce, quality-check, review and distribute content across several brands and sites - Track how often AI answers mention a brand and which sources and competitors they cite ## Version history - 2026-09-16 v3.2.0-beta.1: Beta for development and isolated testing: a standalone remote CLI for named instances, remote theme drafts with live preview, and recovery safeguards coordinated with the Updater. - 2026-09-09 v3.1.0: Pairs with Updater 0.4.0 to add blue/green deployment, automatic migrations and full recovery, plus conversational task creation, site theme packages and AI visibility analysis. - 2026-09-04 v3.0.0: Unifies the product in Admin UI V3 and adds article AI quality checks, hosted channel sites, the Chrome operations assistant and a standalone Updater for signed updates, backups and rollback.