Cypher Generator

February 25, 2026 ยท View on GitHub

The CypherGenerator translates natural language questions into Cypher queries for the knowledge graph.

Usage

import asyncio
from cgr import CypherGenerator

async def main():
    gen = CypherGenerator()
    cypher = await gen.generate("Find all classes that inherit from BaseModel")
    print(cypher)

asyncio.run(main())

Configuration

The Cypher generator uses the configured Cypher provider. Set it via environment variables:

CYPHER_PROVIDER=google
CYPHER_MODEL=gemini-2.5-flash
CYPHER_API_KEY=your-api-key

Or programmatically:

from cgr import settings

settings.set_cypher("google", "gemini-2.5-flash", api_key="your-key")

Supported Providers

ProviderExample Models
Googlegemini-2.5-pro, gemini-2.5-flash
OpenAIgpt-4o, gpt-4o-mini
Ollamacodellama, llama3.2