# Gerolamo

> Competitive intelligence engine that monitors GitHub, arXiv, and Hugging Face for high-velocity entities, scores creator authority, tracks momentum, and assesses defensibility and frontier-lab obsolescence risk. 30,000+ indexed molecules across open-source repos, research papers, and ML models.

Gerolamo provides structured intelligence about the open-source technology landscape. Agents can search, analyze, compare, and compose technology stacks using the API or MCP tools.

## API

- [Search (semantic)](https://gerolamo.onrender.com/api/v1/search?q=autonomous+agents&mode=semantic&limit=10): Semantic search across all corpora using 1024-dim embeddings
- [Search (keyword)](https://gerolamo.onrender.com/api/v1/search?q=autonomous+agents&mode=keyword&limit=10): Full-text keyword search
- [Trending](https://gerolamo.onrender.com/api/v1/trending?limit=20): Entities sorted by velocity (momentum)
- [Defensible](https://gerolamo.onrender.com/api/v1/defensible?limit=20&sort=score): High-defensibility entities with configurable sorting
- [Signals](https://gerolamo.onrender.com/api/v1/signals?min_score=6&max_stars=500&limit=20): High defensibility + low traction — undiscovered gems
- [Entity Detail](https://gerolamo.onrender.com/api/v1/entities/{entity_id}): Full entity with analysis and creators
- [Explore Neighborhood](https://gerolamo.onrender.com/api/v1/explore/{entity_id}): 5 rings of intelligence context around an entity
- [Intelligence Brief](https://gerolamo.onrender.com/api/v1/brief?topic=autonomous+agents&period=7d): Combined situation report: sleepers, trending, breakouts, new entities
- [Creator Profile](https://gerolamo.onrender.com/api/v1/creators/{name}): Creator portfolio with authority score and all molecules
- [Conspectus Topics](https://gerolamo.onrender.com/api/v1/conspectus/topics): AI-generated summaries per topic and corpus
- [Gerolamo Index](https://gerolamo.onrender.com/api/v1/gix): Daily composite score of technology emergence pulse
- [Trajectory](https://gerolamo.onrender.com/api/v1/trajectory/{entity_id}): Time-series traction and velocity for an entity
- [Stats](https://gerolamo.onrender.com/api/v1/stats): Corpus-level counts and embedding coverage

## MCP Tools

- [MCP Server](https://gerolamo.onrender.com/mcp/sse): SSE transport, requires X-API-Key header

Available tools:
- `query_intelligence`: Semantic search across all corpora, returns scored primitives
- `find_sleepers`: High-defensibility, low-traction discovery — hidden gems
- `find_alternatives`: Find projects that could replace a given entity
- `score_stack`: Weakest-link defensibility analysis for a dependency set
- `explain_score`: Full reasoning behind an entity's defensibility score
- `suggest_tools`: Recommend which Gerolamo tools to use for a given task
- `get_intelligence_brief`: Combined situation report for a topic
- `analyze_competitive_landscape`: Velocity-ranked topic analysis
- `compose_molecules`: Fuse entities into specs, comparisons, or research (5 modes)
- `explore_connections`: Entity intelligence neighborhood with threat/opportunity analysis
- `get_creator_profile`: Creator portfolio and authority stats
- `get_creator_network`: Creator collaboration graph
- `get_creator_authority`: Creator authority score lookup
- `find_defensible_clusters`: Cluster detection across the corpus
- `search_intelligence`: RAG-synthesized answer to a question
- `get_my_latest_intelligence`: Subscription alert results
- `check_model_pricing`: Foundation model pricing lookup
- `compare_foundation_models`: Side-by-side model comparison
- `get_domination_risk`: AI capability domination risk analysis
- `create_workspace`: Create a named workspace with entities
- `add_to_workspace`: Add entities to an existing workspace
- `get_tracked_topics`: List all topics Gerolamo tracks with intelligence stats — use for research direction
- `submit_molecule`: Submit a URL for ingestion into the corpus
- `submit_meta_molecule`: Create a speculative meta molecule with parent lineage
- `realize_meta_molecule`: Connect a meta molecule to a real URL for ingestion
- `trace_lineage`: Trace ancestors or descendants of any entity/meta molecule
- `find_family`: Full lineage family view (ancestors + descendants + edges)
- `save_composition`: Persist a generated composition (SPEC.md, research brief, etc.) with lineage tracking

## Data Model

Each indexed entity (molecule) includes:
- `defensibility_score` (1-10): How hard to replicate or displace
- `frontier_risk` (low/medium/high): Likelihood frontier labs build this
- `threat_profile`: Platform domination risk, market consolidation risk, displacement horizon
- `composability_profile`: Tech stack, integration surface, capability tags, novelty assessment
- `traction`: Stars/citations/downloads + velocity (rate of change)
- `creator_authority_scores`: Weighted authority of contributors
- `reasoning`: Detailed competitive analysis explaining the score

## Via Mentis (Foundation Model Tracking)

- [Model Pricing](https://gerolamo.onrender.com/api/v1/mentis/pricing): Pricing comparison across all providers
- [Model Comparison](https://gerolamo.onrender.com/api/v1/mentis/compare?model_id=X&model_id=Y): Side-by-side model comparison
- [Benchmarks](https://gerolamo.onrender.com/api/v1/mentis/benchmarks): Latest benchmark scores per model
- [Domination Risk](https://gerolamo.onrender.com/api/v1/mentis/domination): Which AI capabilities are commoditized vs moated
- [Summary](https://gerolamo.onrender.com/api/v1/mentis/summary): Dashboard overview of all tracked models

## Meta Molecules (Auth Required)

User-created synthetic entities that compose with real molecules. Track lineage, realize as real projects.

- POST `/api/v1/meta-molecules` — Create a meta molecule (monthly limit: 5 free, 50 pro/byok)
- GET `/api/v1/meta-molecules` — List user's meta molecules
- GET `/api/v1/meta-molecules/{id}` — Get a meta molecule (public if visibility=public, else owner only)
- PUT `/api/v1/meta-molecules/{id}` — Update a meta molecule (owner only)
- DELETE `/api/v1/meta-molecules/{id}` — Delete a meta molecule (owner only)
- PATCH `/api/v1/meta-molecules/{id}/realize` — Mark as realized with url and/or entity_id
- PATCH `/api/v1/meta-molecules/{id}/visibility` — Toggle private/public visibility

## Lineage Graph

Directed edges between entities and meta molecules. Track derivation, composition, and inspiration chains.

- POST `/api/v1/lineage/edges` — Create a lineage edge (auth required). Edge types: inspired_by, derived_from, implements, fuses, extends
- DELETE `/api/v1/lineage/edges/{id}` — Remove an edge (creator only)
- GET `/api/v1/lineage/{node_type}/{node_id}/ancestors?max_depth=10` — Walk upstream ancestry
- GET `/api/v1/lineage/{node_type}/{node_id}/descendants?max_depth=10` — Walk downstream descendants
- GET `/api/v1/lineage/{node_type}/{node_id}/family` — Full family: ancestors + descendants + direct edges

Node types: `entity`, `meta_molecule`. Cycle detection on derived_from/implements/fuses edges (max 10 hops).

## Auth

Public endpoints require no authentication. Most AI-powered endpoints (compose, synthesis) require a Bearer token or API key. The `/ask` RAG endpoint is available to all users (free tier uses a lightweight model). Create an account at https://gerolamo.org and generate an API key in Settings for full access.

## Optional

- [GitHub](https://github.com/adjective-rob/gerolamo): Source code
- [Production Site](https://gerolamo.org): Web interface for browsing intelligence