MCPcopy
hub / github.com/dgraph-io/dgraph

github.com/dgraph-io/dgraph @v25.3.7 sqlite

repository ↗ · DeepWiki ↗ · release v25.3.7 ↗
9,777 symbols 44,230 edges 576 files 2,517 documented · 26%
README
  <img alt="Dgraph Logo" src="https://github.com/dgraph-io/dgraph/raw/v25.3.7/logo.png">

GitHub Repo stars GitHub commit activity Go Report Card Docker Pulls

Dgraph is a horizontally scalable and distributed GraphQL database with a graph backend. It provides ACID transactions, consistent replication, and linearizable reads. It's built from the ground up to perform a rich set of queries. Being a native GraphQL database, it tightly controls how the data is arranged on disk to optimize for query performance and throughput, reducing disk seeks and network calls in a cluster.

Dgraph's goal is to provide Google production-level scale and throughput, with low enough latency to serve real-time user queries over terabytes of structured data. Dgraph supports GraphQL query syntax, and responds in JSON and Protocol Buffers over GRPC and HTTP. Dgraph is written using the Go Programming Language.

Status

Dgraph is at version v25 and is production-ready. Apart from the vast open source community, it is being used in production at multiple Fortune 500 companies.

Supported Platforms

Dgraph officially supports the Linux/amd64 and Linux/arm64 architectures. In order to take advantage of memory performance gains and other architecture-specific advancements in Linux, we dropped official support for Mac and Windows in 2021, see this blog post for more information. You can still build and use Dgraph on other platforms (for live or bulk loading for instance), but support for platforms other than Linux/amd64 and Linux/arm64 is not available.

Running Dgraph in a Docker environment is the recommended testing and deployment method.

Install with Docker

If you're using Docker, you can use the official Dgraph image.

docker pull dgraph/dgraph:latest

For more information on a variety Docker deployment methods including Docker Compose and Kubernetes, see the docs.

Run a Quick Standalone Cluster

docker run -it -p 8080:8080 -p 9080:9080 -v ~/dgraph:/dgraph dgraph/standalone:latest

Install from Source

If you want to install from source, install Go 1.24+ or later and the following dependencies:

Ubuntu

sudo apt-get update
sudo apt-get install build-essential

Build and Install

Then clone the Dgraph repository and use make install to install the Dgraph binary in the directory named by the GOBIN environment variable, which defaults to $GOPATH/bin or $HOME/go/bin if the GOPATH environment variable is not set.

git clone https://github.com/dgraph-io/dgraph.git
cd dgraph
make setup
make install

Get Started

To get started with Dgraph, follow:

Is Dgraph the right choice for me?

  • Do you have more than 10 SQL tables connected via foreign keys?
  • Do you have sparse data, which doesn't elegantly fit into SQL tables?
  • Do you want a simple and flexible schema, which is readable and maintainable over time?
  • Do you care about speed and performance at scale?

If the answers to the above are YES, then Dgraph would be a great fit for your application. Dgraph provides NoSQL like scalability while providing SQL like transactions and the ability to select, filter, and aggregate data points. It combines that with distributed joins, traversals, and graph operations, which makes it easy to build applications with it.

Dgraph compared to other graph DBs

Features Dgraph Neo4j Janus Graph
Architecture Sharded and Distributed Single server (+ replicas in enterprise) Layer on top of other distributed DBs
Replication Consistent None in community edition (only available in enterprise) Via underlying DB
Data movement for shard rebalancing Automatic Not applicable (all data lies on each server) Via underlying DB
Language GraphQL inspired Cypher Gremlin
Protocols Grpc / HTTP + JSON / RDF Bolt + Cypher Websocket / HTTP
Transactions Distributed ACID transactions Single server ACID transactions Not typically ACID
Full-Text Search Native support Native support Via External Indexing System
Regular Expressions Native support Native support Via External Indexing System
Geo Search Native support External support only Via External Indexing System
License Apache 2.0 GPL v3 Apache 2.0

Users

Developers

Please see Contributing to Dgraph for guidelines on contributions.

Client Libraries

The Dgraph team maintains several officially supported client libraries. There are also libraries contributed by the community unofficial client libraries.

Contact

Extension points exported contracts — how you extend this code

QueryResolver (Interface)
A QueryResolver can resolve a single query. [7 implementers]
graphql/resolve/query.go
Tokenizer (Interface)
Tokenizer defines what a tokenizer must provide. [17 implementers]
tok/tok.go
AclEntity (Interface)
AclEntity is an interface that must be met by all the types of entities (i.e users, groups) in the ACL system. [5 implementers]
acl/acl.go
Writer (Interface)
(no doc) [6 implementers]
worker/restore_reduce.go
LocalCache (Interface)
Local cache is an interface representation of the local cache of a persistent storage system [4 implementers]
tok/index/index.go
Stopper (Interface)
Stopper is an interface tasked with stopping the profiling process. [3 implementers]
x/profile.go
UriHandler (Interface)
UriHandler interface is implemented by URI scheme handlers. When adding new scheme handles, for example 'azure://', an o [2 …
worker/backup_handler.go
OffsetTimer (Interface)
An OffsetTimer is used to fill out an OffsetDuration. Start starts the timer and calculates the offset. Stop calculate [2 …
graphql/schema/response.go

Core symbols most depended-on inside this repo

Errorf
called by 2034
x/log.go
Error
called by 1203
x/x.go
Run
called by 625
lex/lexer.go
ExecuteAsPost
called by 419
graphql/e2e/common/common.go
RequireNoGQLErrors
called by 414
graphql/e2e/common/common.go
Check2
called by 407
x/error.go
Infof
called by 390
x/log.go
Get
called by 348
tok/index/index.go

Shape

Function 5,414
Method 3,324
Struct 848
TypeAlias 88
Interface 79
FuncType 24

Languages

Go100%
TypeScript1%

Modules by API surface

protos/pb/pb.pb.go835 symbols
graphql/schema/wrappers.go363 symbols
dql/parser_test.go292 symbols
protos/pb/pb_grpc.pb.go275 symbols
tok/tok.go149 symbols
query/query2_test.go141 symbols
query/query3_test.go133 symbols
query/query1_test.go129 symbols
query/query0_test.go120 symbols
graphql/e2e/common/mutation.go109 symbols
graphql/e2e/common/query.go103 symbols
posting/list.go101 symbols

Dependencies from manifests, versioned

filippo.io/edwards25519v1.2.0 · 1×
github.com/HdrHistogram/hdrhistogram-gov1.2.0 · 1×
github.com/IBM/saramav1.48.0 · 1×
github.com/Masterminds/semver/v3v3.4.0 · 1×
github.com/Microsoft/go-winiov0.6.2 · 1×
github.com/agnivade/levenshteinv1.2.1 · 1×
github.com/beorn7/perksv1.0.1 · 1×
github.com/bits-and-blooms/bitsetv1.24.4 · 1×
github.com/blevesearch/bleve/v2v2.5.7 · 1×
github.com/blevesearch/bleve_index_apiv1.3.11 · 1×
github.com/blevesearch/geov0.2.5 · 1×

For agents

$ claude mcp add dgraph \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact