Overview
Geode is an enterprise-ready graph database implementing the ISO/IEC 39075:2024 Graph Query Language (GQL) 100% compliance. Designed for production workloads, Geode combines standards alignment, high performance, and comprehensive security features.
What is Geode?
Geode is a property graph database that stores data as nodes, relationships, and properties. Unlike traditional relational databases optimized for tabular data, Geode excels at representing and querying highly connected data where relationships between entities are as important as the entities themselves.
Built from the ground up in Zig for performance and memory safety, Geode is designed for high-throughput workloads. The modern QUIC+TLS transport ensures secure, low-latency communication with connection migration support.
Key Features
Standards Compliance
- 100% GQL compliance: Deterministic ordering and pagination policies with MATCH semantics
- Standards-Based: No vendor-specific query language extensions required
- Future-Proof: Built on internationally recognized standards
Enterprise Security
- Transparent Data Encryption (TDE): AES-256-GCM encryption at rest
- Field-Level Encryption (FLE): Searchable encryption for sensitive data
- Row-Level Security (RLS): Fine-grained access control with policy evaluation
- Comprehensive Audit Logging: Full compliance trail for GDPR, SOX, HIPAA, PCI-DSS
- MFA Support: Multi-factor authentication with TOTP
- KMS Integration: HashiCorp Vault for key management
Optimized Architecture
- Memory-Mapped I/O: Efficient storage with page-level caching
- SIMD Optimization: Vectorized operations for supported workloads
- Six Index Types: B-tree, Hash, HNSW, R-tree, Full-text, Patricia Trie
Advanced Features
- Distributed Deployment: Up to 32 shards with Raft consensus
- Machine Learning: Node2Vec, GraphSAGE, DeepWalk embeddings
- Real-time Analytics: Streaming pattern detection with ML anomaly detection
- Vector Search: Approximate K-NN with HNSW indexes
- Geospatial: R-tree indexing with Haversine distance
- Full-Text Search: BM25 ranking with stemming
Production Ready
- 97.4% Test Coverage: 1,644/1,688 tests passing
- ACID Transactions: Full transactional guarantees with MVCC
- 6 Isolation Levels: Read Uncommitted to Linearizable
- WAL for Durability: Point-in-time recovery support
- Evidence-Based Development: 1,735 CANARY markers tracking 2,190+ requirements
Topics in This Section
- Introduction - Detailed introduction to Geode including architecture overview, feature highlights, and comparison with other graph databases
Why Choose Geode?
Standards-Based
Geode implements the ISO/IEC 39075:2024 GQL standard, ensuring your queries and data models are portable and future-proof. No vendor lock-in with proprietary query languages.
Enterprise-Grade Security
From encryption at rest (TDE) to fine-grained access control (RLS), Geode provides the security features enterprises require. Comprehensive audit logging supports compliance with major regulations.
Optimized for Graph Workloads
Memory-mapped I/O, SIMD optimization, and six specialized index types are designed for efficient graph traversal and query execution.
Modern Architecture
Built with modern technologies: Zig for performance and safety, QUIC for efficient networking, MVCC for high concurrency, and Raft for distributed consensus.
Developer Friendly
- LSP Support: IDE integration for any editor
- Interactive REPL: Powerful shell for query development
- Client Libraries: Go, Python, Rust, Node.js, and Zig with idiomatic APIs
- Comprehensive Documentation: 40+ guides and references
Use Cases
Geode excels at use cases requiring complex relationship queries:
Social Networks
Model users, posts, followers, and interactions. Query friend networks, detect communities, and generate recommendations with natural graph patterns.
Fraud Detection
Identify suspicious transaction patterns, detect fraud rings, and analyze behavioral anomalies in financial networks.
Knowledge Graphs
Build enterprise knowledge graphs connecting people, documents, projects, and concepts. Enable semantic search and knowledge discovery.
See: Knowledge Graphs Use Case
Recommendation Engines
Generate personalized recommendations based on user behavior, product relationships, and collaborative filtering patterns.
Supply Chain
Track products, suppliers, logistics, and dependencies across complex supply networks. Analyze impact of disruptions and optimize routing.
Architecture Highlights
Query Pipeline
GQL Parser → Planner (CBO) → Execution Engine → Storage Engine
- Parser: ISO/IEC 39075:2024 syntax coverage (see conformance profile)
- Planner: Cost-based optimization with statistics
- Execution: Optimized for graph traversal patterns
- Storage: Memory-mapped I/O with WAL
Storage Engine
- Page Manager: 8KB pages with LRU cache
- WAL: Segment-based with checkpointing
- Indexes: Six types for different access patterns
- MVCC: Serializable Snapshot Isolation
Network Layer
- QUIC Transport: Modern protocol with multiplexing
- TLS 1.3: Mandatory encryption
- Protobuf Wire Protocol: Compact binary transport over QUIC or gRPC
- Connection Migration: Support for mobile clients
See Architecture for complete details.
Quality Metrics
Test Coverage
- 97.4% Integration Test Pass Rate: 1,644/1,688 tests
- 100% Unit Test Pass Rate: 393/393 tests
- GQL conformance profile: see conformance profile
- 1,735 CANARY Markers: Tracking 2,190+ requirements
Status Breakdown
- 81.4% TESTED: Full test coverage with evidence
- 6.0% BENCHED: Performance benchmarks
- 7.7% EXEMPT: Documentation and metadata
- 5.7% IMPL: Implementation without tests
Quick Start
Get started with Geode in minutes:
# Install (choose one method)
# Linux binary (example)
curl -L -o geode-linux-amd64 https://gitlab.com/devnw/codepros/geode/geode/-/releases/latest/download/geode-linux-amd64
sudo install -m 0755 geode-linux-amd64 /usr/local/bin/geode
# Docker
docker pull geodedb/geode:latest
# From source
git clone https://github.com/codeprosorg/geode
cd geode
make build
# Start server
geode serve --listen 0.0.0.0:3141
# Connect with shell
geode shell
# Run first query
RETURN 1 AS x;
See Installation Guide for detailed instructions.
Community and Support
Documentation
- GQL Guide : Complete query language reference
- Architecture : System design and internals
- API Reference : Complete API documentation
- Tutorials : Hands-on learning resources
Contributing
Geode is open source and welcomes contributions. See Contributing Guide for how to get involved.
License
Geode is licensed under the Apache License 2.0.
Learn More
- Introduction - Detailed introduction and feature overview
- Installation Guide - Get Geode running
- GQL Guide - Learn the query language
- Data Model - Understand property graphs
- Use Cases - Real-world applications
Next Steps
- Install Geode - Get the database running
- Learn GQL - Master the query language
- Explore Tutorials - Hands-on learning
- Build Applications - Connect from your code
- Deploy to Production - Go live