Self-hosted, agent-first AEO platform that tracks brand visibility in AI answer engines alongside search, traffic, and site health data.
elmohq/elmo
Self-hosted open-source platform that tracks how AI answer engines like ChatGPT, Claude, Perplexity and Gemini mention and cite your brand.
Open-source alternative to:Profound
Otterly.ai
Peec AI
- Stars
- 479
- Forks
- 112
- Open issues
- 135
- Last commit
- 4 hours ago
What is it?
Elmo is a platform for measuring and improving AI visibility, also called Answer Engine Optimization (AEO) or Generative Engine Optimization (GEO). You define prompts a potential customer might ask an AI assistant, and Elmo runs them on a schedule against engines such as ChatGPT, Google AI Overviews, Gemini, Perplexity, Copilot, and Claude or Grok through direct model APIs.
Each answer is parsed for your brand name, aliases, domains and competitors, and mentions are scored with sentiment and ranking position. Cited URLs are stored and grouped by domain and category, so you can see which sources the engines rely on. Raw responses are kept in PostgreSQL, and the scoring code lives in the repository so every metric can be audited.
The project ships as a Docker Compose stack installed through an npm CLI, and includes a REST API with TypeScript and Python SDKs and an MCP server for coding assistants. Shareable reports can be viewed without an account.
Key features
- 01Tracks brand mentions and citations across ChatGPT, Perplexity, Gemini, Claude and Google AI Overviews.
- 02Scores visibility, share of voice and sentiment per prompt, model and competitor.
- 03Categorizes cited URLs by domain, including your own sites, competitors and social media.
- 04Records the web searches engines run while answering, showing query fan-out.
- 05Stores raw engine output in PostgreSQL so metrics can be re-derived and audited.
- 06Provides a REST API, TypeScript and Python SDKs, and an MCP server.
Use cases
- Marketing teams tracking how AI assistants describe their brand against competitors.
- Agencies running AEO reports for multiple clients with white-label deployments.
- Companies that want AI visibility data kept in their own infrastructure.
- Developers querying AI visibility data from coding assistants through MCP.
Quick start
- 1
Install the Elmo CLI globally
npm install -g @elmohq/cli - 2
Run the interactive setup wizard to create configuration
elmo init - 3
Start the Docker Compose stack
elmo compose up -d - 4
Open http://localhost:1515 in your browser and create an account
Things to know
- Requires API keys for at least one AI provider or scraper, plus a TypeSafe key for Jev.
- Running the tracking costs money per answer judged, on top of self-hosting effort with Docker Compose.
Topics
FAQ
- What is elmo?
- Self-hosted open-source platform that tracks how AI answer engines like ChatGPT, Claude, Perplexity and Gemini mention and cite your brand. Elmo is a platform for measuring and improving AI visibility, also called Answer Engine Optimization (AEO) or Generative Engine Optimization (GEO). You define prompts a potential customer might ask an AI assistant, and Elmo runs them on a schedule against engines such as ChatGPT, Google AI Overviews, Gemini, Perplexity, Copilot, and Claude or Grok through direct model APIs.
- Is elmo free to use? What license does it have?
- elmo is open source under the MIT license. Check the license terms before using it in commercial products.
- Is elmo still maintained?
- Actively maintained. The last commit to elmo was on Oct 22, 2026.
- What can I use elmo for?
- Marketing teams tracking how AI assistants describe their brand against competitors. Agencies running AEO reports for multiple clients with white-label deployments. Companies that want AI visibility data kept in their own infrastructure. Developers querying AI visibility data from coding assistants through MCP.
- How do I install elmo?
- Install the Elmo CLI globally: npm install -g @elmohq/cli Run the interactive setup wizard to create configuration: elmo init Start the Docker Compose stack: elmo compose up -d Open http://localhost:1515 in your browser and create an account
- Where can I get elmo?
- The source code and installation instructions are on GitHub: https://github.com/elmohq/elmo
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Free 0–100 score for how well AI answer engines can reach, parse and cite a website, plus optional citation tracking with your own API keys.
Open-source platform for tracking how brands appear in AI search answers across ChatGPT, Gemini, Claude, Perplexity and other engines.
A set of three Claude Code/Codex agent skills for Generative Engine Optimization (GEO), helping content get cited by AI search engines like ChatGPT and Perplexity.
Open-source CLI and Python toolkit that scores a website 0–100 on AI answer-engine readiness and generates fixes for ChatGPT, Perplexity, Gemini and Google AI Overviews citations.
Open source, self-hostable SEO toolkit for keyword research, rank tracking, backlinks, site audits and AI visibility, with an MCP server for AI agents.