Skip to content

About

Evidence-led AI visibility, brand mentions, and content improvements.

Topics

Resources

Contributing

Stars

8 stars

Watchers

0 watching

Forks

Latest commit

 

History

50 Commits

Folders and files

Repository files navigation

Repository summary

ZZ Geo

Is your brand showing up in AI answers? Find the evidence, then improve.

ZZ Geo

An evidence-led workspace for brand mentions, answer sources, website audits, content improvements, and matched retest reports. Built for brand teams, content teams, and GEO service providers.

Self-hosted · AGPL-3.0-only

Interactive demo · Website · Help center · Quick start

Sampling uses provider APIs, not consumer-app answers. Matched retests support comparison, not causal proof. No guarantee of inclusion or ranking is made.

From questions to evidence

flowchart LR
    A[Confirm client context and questions] --> B[Provider web-search API sampling]
    B --> C[Answer evidence and metrics]
    C --> D[Website audit and gap diagnosis]
    D --> E[Remediation and article drafts]
    E --> F[Quality checks and human review]
    F --> G[Manual publication and receipts]
    G --> H[Matched retests and reports]
Loading

Original answers, frozen configuration, sources, approvals, and report snapshots remain available for verification. Failures, unknowns, and missing evidence are not filled with synthetic data.

Interface preview

AI workbench Remediation center
AI workbench Remediation center
Website audit Article improvements
Website audit Article improvements

Screenshots show the actual interface as of September 9, 2026, with sensitive business data removed and empty states preserved. They are not proof of customer outcomes. See the illustrated user guide.

Capabilities

Area How it works
Client and question research Manage clients, competitors, brand aliases, and candidate questions; members confirm the monitoring scope
Multi-provider sampling DeepSeek, Kimi, Doubao / Volcengine Ark, Qwen DashScope, and Yuanbao search sources with Hunyuan synthesis
Evidence and metrics Preserve original answers, distinguish search sources from final citations, and explain mentions, explicit recommendations, and valid denominators
Website audits and remediation Retain page sources, screenshots, and evidence; create traceable, assignable tasks with acceptance criteria
Agent workbench Organize work in natural language with project-scoped controlled tools and human approval of structured drafts where required
Content operations Maintain knowledge revisions, article versions, review, quality gates, and manual publication receipts
Retesting and reports Reuse the full baseline configuration; freeze report snapshots and generate online reports, PDF, and Word
Team collaboration Organization, role, and client-scoped access with audit and execution logs

The Yuanbao channel combines Yuanbao search sources with Hunyuan synthesis. Reusing sampling configuration reduces condition differences; it does not independently establish the causal effect of content changes.

Quick start

For a first deployment, follow Docker quick start:

bash docker/quickstart/start.sh

On Windows: powershell -ExecutionPolicy Bypass -File docker/quickstart/start.ps1. The script asks for an administrator email, generates random keys, and starts nine services.

Local source development

Requirements: Node.js 24, Corepack, and pnpm 11. Run commands from the complete source root. Use macOS, Linux, or Windows WSL for local development; PGlite is for local development and testing only.

corepack pnpm install --frozen-lockfile
corepack pnpm --filter @geo/worker exec playwright install chromium

macOS stores the master key in the system keychain. On Linux/WSL, securely retain a 32-byte Base64 master key and choose a new, separate data directory:

export GEO_DATA_DIR="$PWD/.geo-data"
# Generate only for first-time initialization. Retain and reuse this exact key.
export GEO_MASTER_KEY="$(node -e "process.stdout.write(require('node:crypto').randomBytes(32).toString('base64'))")"
corepack pnpm geo setup
corepack pnpm geo start

Startup prints the local workbench address on port 3000. Before starting, make sure DATABASE_URL does not point to an existing external database. For first-time local use, leave it unset and use a new PGlite database. Do not regenerate the master key on every restart: existing provider credentials would become unreadable.

Configure providers and the HRouter model in platform settings, then define clients and question scopes. Collection, connectivity checks, and model calls may incur API charges. Native Windows process invocation has limitations; WSL is recommended.

See deployment for server installation, backups, updates, and rollback. Operating system, Node, database, and model/API services are required infrastructure.

Documentation and development

Detailed guides are primarily in Chinese; use the language switch for the original project introduction.

corepack pnpm check-types
corepack pnpm test
corepack pnpm build
corepack pnpm lint
corepack pnpm license-check

License, privacy, and services

Project-owned code is licensed under AGPL-3.0-only. Consult the full license for use, modification, distribution, and network-service obligations; third-party code retains its licenses in NOTICE and THIRD_PARTY_NOTICES.md. Open source does not mean publishing client data, accounts, credentials, databases, or original private evidence. Infrastructure, storage, and third-party API costs are yours.

Access to the official evaluation environment is arranged manually; no login address is published here. Email honest.tai@outlook.com with your team, intended use, and workflows to request access or discuss deployment, training, and customization.

Maintained by honestTai, who also operates HRouter.


Project activity

Star / Fork totals and retained-event history, scheduled to refresh daily.

Star and Fork history for geo-console

Observed daily totals · Methodology · All public projects

Historical curves reconstruct currently retained stars and visible forks, not historical net totals. Separate daily observations start on 2026-10-06; no fabricated backfill.

About

Evidence-led AI visibility, brand mentions, and content improvements.

Topics

Resources

Contributing

Stars

8 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages