GEOFlow is an open-source content production system designed for GEO/SEO content operations. It streamlines the entire content lifecycle, from AI model configuration and material management to task scheduling, review workflows, and front-end publishing. This system benefits users aiming to build automated content websites or internal content operation backends by providing a robust, integrated platform for efficient content generation and management.

How It Works

GEOFlow orchestrates content production through a defined pipeline: configuring AI models, prompts, and materials in the backend; creating tasks; scheduling these tasks for execution; workers then call AI models to generate content, optionally adding illustrations and SEO metadata. Generated articles proceed through a draft, review, and publishing workflow before being outputted to the front-end website. The architecture comprises a Web/Admin interface for user interaction, an API/CLI for machine access, a Scheduler and Workers for AI generation, Domain Services for core business logic, and PostgreSQL for data persistence. This approach allows integration with various AI providers via OpenAI-compatible APIs and ensures reliable data handling.

Quick Start & Requirements

The recommended installation method is via Docker Compose. This involves cloning the repository, copying and configuring the .env.example file, and then running docker compose --profile scheduler up -d --build. An alternative local setup using PHP 7.4+ with pdo_pgsql and curl extensions is also provided. Prerequisites include Docker, Git, and a PostgreSQL database (or the local PHP environment). Detailed documentation is available within the docs/ directory of the repository.

Highlighted Details

• Multi-Model Content Generation: Compatible with OpenAI-style APIs, enabling integration with diverse AI service providers.
• Batch Task Execution: Features task creation, scheduled execution, queue processing, and automatic retries for failed jobs.
• Unified Material Management: Centralized management for titles, keywords, images, knowledge bases, and prompt templates.
• Review and Publishing Workflow: Supports a three-stage process (draft, review, publish) with an option for automatic publishing.
• SEO Optimization: Includes generation of SEO meta-information, Open Graph tags, and structured data for articles.
• Database: Utilizes PostgreSQL for robust runtime operation and concurrent write capabilities.
• Deployment: Docker Compose support simplifies deployment on both local machines and servers.

Maintenance & Community

The project provides multi-language READMEs (including English, Chinese, Japanese, Spanish, and Russian). A complementary "Skill" repository, yaojingang/yao-geo-skills, is available for CLI-based operations. Specific details regarding active maintainers, community forums (like Discord/Slack), or a public roadmap are not explicitly detailed in the provided README.

Licensing & Compatibility

GEOFlow is released under the Apache License 2.0. This license is generally permissive, allowing for commercial use and integration into closed-source projects without significant copyleft restrictions.

Limitations & Caveats

The publicly available open-source repository does not include production databases, uploaded files, or actual API keys, serving primarily as a foundation for development. Users must change the default administrator credentials (admin/admin888) and the APP_SECRET_KEY before deploying to a production environment. The system is designed to run on PostgreSQL.