Sign inSign up

ouai2h/gego

By ouai2h

•Updated 2 months ago

Image
0

1.5K

ouai2h/gego repository overview

⁠Gego

Open-source GEO (Generative Engine Optimization) tracker. Schedules prompts across LLMs, captures web-search citations, tracks brand mentions, and serves analytics through a built-in dashboard.

This image bundles the API + pre-built UI in a single container (port 8989).

⁠Quick start

docker pull ouai2h/gego:latest

docker run -d \
  --name gego \
  -p 8989:8989 \
  -e GEGO_POSTGRES_URI=postgres://user:pass@your-postgres-host:5432/gego?sslmode=disable \
  -e GEGO_MONGODB_URI=mongodb://your-mongodb-host:27017 \
  -e GEGO_MONGODB_DATABASE=gego \
  -e GEGO_JWT_SECRET="your-secret-at-least-32-characters-long" \
  -e GEGO_BOOTSTRAP_ADMIN_PASSWORD="your-admin-password" \
  ouai2h/gego:latest

Then open:

  • Dashboard: http://localhost:8989
  • Health: http://localhost:8989/api/v1/health

⁠What you need

Gego expects these services alongside the container:

ServiceRole
PostgreSQLConfig, auth, brands, schedules
MongoDBPrompts, responses, analytics
etcdJob queue for scheduled / manual runs

For full server deployment steps, see DEPLOYMENT.md⁠.

⁠Tags

TagMeaning
latest / mainLatest build from main
vX.Y.ZRelease version
X.Y / XSemver aliases
sha-<commit>Exact commit build

Multi-arch: linux/amd64, linux/arm64.

⁠Environment variables

VariableDescription
GEGO_POSTGRES_URIPostgreSQL connection string
GEGO_MONGODB_URIMongoDB connection string
GEGO_MONGODB_DATABASEMongoDB database name (default: gego)
GEGO_ETCD_ENDPOINTSComma-separated etcd endpoints (default: 127.0.0.1:2379)
GEGO_JWT_SECRETJWT signing secret (min 32 characters, required)
GEGO_BOOTSTRAP_ADMIN_USERNAMEFirst admin username (default: admin)
GEGO_BOOTSTRAP_ADMIN_PASSWORDFirst admin password (min 8 characters, required on first run)
GEGO_COOKIE_SECURESet to true to mark auth cookies as Secure
GEGO_CONFIG_PATHConfig file path (default: /app/config/config.yaml)
GEGO_DATA_PATHLegacy SQLite data directory (default: /app/data)
GEGO_LOG_PATHLog directory (default: /app/logs)

⁠Features

  • Multi-LLM: OpenAI, Anthropic, Ollama, Google, Perplexity, and custom providers
  • Brand & citation tracking from LLM web-search results
  • Keyword analytics with exclusion words
  • Cron scheduler + workers via etcd
  • JWT auth with roles (admin, member)
  • Vue dashboard served from the same image

⁠Links

Tag summary

Content type

Image

Digest

sha256:b32c21273…

Size

20.6 MB

Last updated

2 months ago

docker pull ouai2h/gego