{"id":23812,"library":"grafeo","title":"Grafeo","description":"A high-performance, embeddable graph database with Python bindings. Current version 0.5.41, released 2026-04-24. Rapid release cadence, often multiple releases per week. Supports multiple query languages (GQL, Cypher, SPARQL, GraphQL, SQL/PGQ, Gremlin), hybrid graph+vector+text search, encryption at rest, and role-based access control.","status":"active","version":"0.5.41","language":"python","source_language":"en","source_url":"https://github.com/GrafeoDB/grafeo","tags":["graph-database","embeddable","high-performance","cypher","sparql","gql","vector-search"],"install":[{"cmd":"pip install grafeo","lang":"bash","label":"PyPI"}],"dependencies":[],"imports":[{"note":"The package is 'grafeo', not 'grafeodb'.","wrong":"from grafeodb import GrafeoDB","symbol":"GrafeoDB","correct":"from grafeo import GrafeoDB"},{"note":"","wrong":"","symbol":"GrafeoSession","correct":"from grafeo import GrafeoSession"},{"note":"","wrong":"","symbol":"QueryResult","correct":"from grafeo import QueryResult"}],"quickstart":{"code":"from grafeo import GrafeoDB\n\ndb = GrafeoDB(\"mygraph.grafeo\")\nsession = db.session()\nresult = session.execute(\"CREATE (a:Person {name: 'Alice'}) RETURN a\")\nprint(result.rows())\ndb.close()","lang":"python","description":"Creates an embedded graph database, opens a session, runs a Cypher query, prints results."},"warnings":[{"fix":"Replace .rows with .rows() or .into_rows().","message":"Starting from v0.5.35, QueryResult.rows is private; use rows() or into_rows() instead.","severity":"breaking","affected_versions":">=0.5.35"},{"fix":"Export data from old database and import into new database.","message":"On-disk storage format changed in v0.5.35 from bincode blobs to block-based sections. Databases created with 0.5.34 or earlier must be re-created.","severity":"breaking","affected_versions":">=0.5.35"},{"fix":"Ensure all parameter types are supported (strings, numbers, etc.).","message":"QueryBuilder.param() now raises ValueError on unsupported types instead of silently dropping them (since v0.5.38).","severity":"breaking","affected_versions":">=0.5.38"},{"fix":"Switch to persona-based profiles when installing or building from source.","message":"Feature profiles 'embedded', 'browser', 'server', 'full' are deprecated in v0.5.35; use persona-based profiles: 'lpg', 'rdf', 'analytics', 'ai', 'edge', 'enterprise'.","severity":"deprecated","affected_versions":">=0.5.35"},{"fix":"Pass encryption config on first open; if re-creating, use compact() on the original first.","message":"When using encryption at rest (AES-256-GCM), the password or key must be provided at database creation time and cannot be changed later without re-encryption.","severity":"gotcha","affected_versions":">=0.5.39"},{"fix":"Ensure system clock is synchronized (e.g., NTP).","message":"HLC timestamps (Hybrid Logical Clock) introduced in v0.5.32 are mandatory for causal consistency. Sessions may fail if clocks are skewed beyond accepted drift.","severity":"gotcha","affected_versions":">=0.5.32"},{"fix":"Install with correct profile: pip install grafeo[ai] or similar.","message":"Vector search requires the 'ai' or 'analytics' profile. Plain 'lpg' or 'rdf' profiles may not include vector indexes.","severity":"gotcha","affected_versions":">=0.5.35"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Install 'grafeo' and import as 'from grafeo import GrafeoDB'.","cause":"Wrong import; package name is 'grafeo' not 'grafeodb'.","error":"ModuleNotFoundError: No module named 'grafeodb'"},{"fix":"Use .rows() or .into_rows() instead.","cause":"Attribute .rows is private since v0.5.35.","error":"AttributeError: 'QueryResult' object has no attribute 'rows'"},{"fix":"Pass only str, int, float, bool, None, or bytes.","cause":"QueryBuilder.param() rejects unsupported types since v0.5.38.","error":"ValueError: unsupported type for parameter"},{"fix":"Re-create database from scratch or migrate via export/import.","cause":"Database created with pre-0.5.35 version.","error":"grafeo.exceptions.StorageError: database format is too old"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}