cypherdb 0.2.2

CypherDB is a lightweight, zero-dependency, embedded graph database written entirely in Go. Think of it as SQLite for Graph Databases

GoGraph

The Minimalist Embedded Graph Database in Pure Go and Python bindings

---

📖 Project Overview

GoGraph is a lightweight, zero-dependency, embedded graph database written entirely in Go. Think of it as "SQLite for Graph Databases".

It allows Go and Python developers to execute Cypher queries (the standard graph query language) and manage local graph data—nodes, relationships, and properties—without the overhead of external heavy database services like Neo4j.

⚡ Quick Start

1. Install CLI (Recommended)

The fastest way to explore GoGraph is via the CLI.

macOS / Linux (Homebrew):

brew install dotnetage/tap/gograph

Run TUI (Interactive Shell):

# Simply run without arguments to open default.db in interactive mode
gograph

2. Use as a python package

Basic Example:

import gograph

# 创建数据库
db = gograph.Database("my_graph.db")

# 使用事务
with db.transaction() as tx:
    node_id = tx.create_node("Person", {"name": "Alice"})
    print(f"Created node: {node_id}")
    # 自动提交

# 手动事务
tx = db.transaction()
try:
    tx.create_node("Person", {"name": "Bob"})
    tx.commit()
except:
    tx.rollback()

✨ Key Features

• 🚀 Pure Go: No CGO, seamless cross-platform support.
• 📦 Embedded: Zero-config, single-directory storage (Pebble DB).
• 🔍 Cypher Support: Native MATCH, CREATE, SET, DELETE.
• 🛡️ ACID: MVCC, thread-safety, and WAL recovery.
• 🛠️ TUI Included: Interactive shell with auto-completion and ASCII tables.

💻 CLI Usage

The gograph binary provides a powerful TUI and command-line utilities.

Command	Description
gograph	Launch Interactive TUI (default to default.db)
gograph query <cypher>	Run a read-only query
gograph exec <cypher>	Run a data modification command

Example:

gograph query "MATCH (n) RETURN n"

---

🧩 System Compatibility

• OS: macOS, Linux, Windows.
• Arch: amd64, arm64.

📚 Documentation

Check out the full Documentation or the Docs Folder.