Skip to main content
GEO AI is a modern WordPress SEO plugin optimized for AI answer engines (Google AI Overviews, Perplexity, ChatGPT). Choose the installation method that fits your workflow.

​
Requirements

Before installing, ensure your environment meets these requirements:
  • WordPress: 6.2 or higher
  • PHP: 8.1 or higher
  • Gutenberg: Block editor must be enabled (for Answer Card block and editor sidebar)
  • Google Gemini API Key: Free tier available at Google AI Studio

​
WordPress Admin Install

Recommended for most users. No command line required.
1

Download the Plugin

Download the latest .zip release file from the releases page.
2

Upload to WordPress

  1. Go to Plugins → Add New → Upload Plugin
  2. Click Choose File and select the downloaded .zip
  3. Click Install Now
3

Activate

Click Activate Plugin once the upload completes.
4

Configure Settings

Navigate to Settings → GEO AI to begin configuration. See the Configuration page for details.

​
Manual Installation

For users who want to install from source or deploy to custom environments.
1

Clone or Download the Repository

git clone https://github.com/fredoyetayo/geo-ai.git
cd geo-ai
2

Install JavaScript Dependencies

npm install
3

Download Action Scheduler

GEO AI uses Action Scheduler for background task processing. Choose one option:Option A: Download from WordPress.org
mkdir -p vendor
cd vendor
wget https://downloads.wordpress.org/plugin/action-scheduler.latest-stable.zip
unzip action-scheduler.latest-stable.zip
rm action-scheduler.latest-stable.zip
cd ..
Option B: Use Composer
composer require woocommerce/action-scheduler
4

Build JavaScript Assets

npm run build
This compiles:
  • src/editor.js → build/editor.js (Editor sidebar plugin)
  • blocks/answer-card/* → build/answer-card/ (Answer Card block)
5

Upload to WordPress

Copy the entire geo-ai folder to your WordPress plugins directory:
cp -r geo-ai /path/to/wordpress/wp-content/plugins/
6

Activate via WordPress Admin

  1. Go to Plugins in WordPress admin
  2. Find “GEO AI (AI SEO)”
  3. Click Activate
7

Flush Permalinks

After activation, go to Settings → Permalinks and click Save Changes to flush rewrite rules for sitemaps.

​
Development Setup

For plugin developers contributing to GEO AI or extending functionality.

​
Prerequisites

  • Node.js 18+
  • npm or yarn
  • PHP 8.1+
  • WordPress 6.2+ development environment
  • Composer (optional, for PHPCS)

​
Quick Setup with wp-env

1

Install wp-env Globally

npm install -g @wordpress/env
2

Clone Repository

git clone https://github.com/fredoyetayo/geo-ai.git
cd geo-ai
3

Install Dependencies

npm install
4

Start WordPress Environment

npx wp-env start
Your local WordPress site will be available at:
5

Build Assets in Watch Mode

npm start
This runs webpack in watch mode - files rebuild automatically when you make changes.

​
Development Commands

npm start
For development without wp-env, use a symlink: 
ln -s /path/to/geo-ai /path/to/wordpress/wp-content/plugins/geo-ai

​
File Structure After Build

geo-ai/
├── geo-ai.php                 # Main plugin file
├── includes/                  # PHP classes
│   ├── class-geoai-admin.php
│   ├── class-geoai-rest.php
│   ├── class-geoai-analyzer.php
│   └── ...
├── blocks/                    # Block source files
│   └── answer-card/
│       ├── block.json
│       ├── index.js
│       ├── edit.js
│       └── save.js
├── src/                       # JavaScript source
│   └── editor.js             # Editor sidebar
├── build/                     # Compiled JS (npm build output)
│   ├── editor.js
│   ├── editor.asset.php
│   └── answer-card/
├── assets/                    # Static CSS/JS
│   ├── admin.css
│   └── admin.js
└── vendor/                    # Third-party libraries
    └── action-scheduler/      # Background task processor

​
Troubleshooting

Cause: Action Scheduler library is missing.Solution: Ensure Action Scheduler is downloaded to vendor/action-scheduler/. Follow Step 3 in Manual Installation.
Cause: Assets not built.Solution: Run npm install followed by npm run build from the plugin directory.
Cause: Rewrite rules not flushed after activation.Solution: Go to Settings → Permalinks in WordPress admin and click Save Changes.
Cause: File permission issues or missing PHP sodium extension.Solution:
  • Check that wp-content/uploads/ has write permissions
  • Verify PHP sodium extension is available: php -m | grep sodium
Cause: Corrupted or outdated dependencies.Solution:
rm -rf node_modules package-lock.json
npm install
npm run build

​
Next Steps

Quick Start

Run your first AI audit in 5 minutes

Configuration

Configure API key, templates, and settings

Build docs developers (and LLMs) love

Get started for freeTalk to us