ArcadeDB Python Bindings

Native Python bindings for ArcadeDB - the multi-model database that supports Graph, Document, Key/Value, Search Engine, Time Series, and Vector models.

Status: ✅ Production Ready | Tests: 397 Passed | Platforms: 4 Supported

📚 Documentation

📖 Read the Full Documentation →

🚀 Quick Start

Installation

uv add arcadedb-embedded   # or: pip install arcadedb-embedded

Requirements:

Python 3.10–3.14 (packaged/tested on CPython 3.12) - No Java installation required!
Supported Platforms: Prebuilt wheels for 4 platforms
- Linux: x86_64, ARM64
- macOS: Apple Silicon (ARM64)
- Windows: x86_64

5-Minute Example

import arcadedb_embedded as arcadedb

# Create database (context manager for automatic open and close)
with arcadedb.create_database("./mydb") as db:
    # Create schema (DDL)
    db.command("sql", "CREATE DOCUMENT TYPE Person")
    db.command("sql", "CREATE PROPERTY Person.name STRING")
    db.command("sql", "CREATE PROPERTY Person.age INTEGER")

    # Insert data (requires transaction)
    with db.transaction():
        db.command("sql", "INSERT INTO Person SET name = 'Alice', age = 30")

    # Query data
    result = db.query("sql", "SELECT FROM Person WHERE age > 25")
    for record in result:
        print(f"Name: {record.get('name')}")

👉 See full tutorial

✨ Features

☕ No Java Installation Required: Bundled JRE (~63MB uncompressed)
🌍 4 Platforms Supported: Linux (x86_64, ARM64), macOS (ARM64), Windows (x86_64)
🚀 Embedded Mode: Direct database access in Python process (no network)
🌐 Server Mode: Optional in-process HTTP server with the Studio web UI — costs ~8MB of wheel and nothing at runtime until you call create_server()
📦 Self-contained: All dependencies bundled (~67MB current Linux wheel)
🔄 Multi-model: Graph, Document, Key/Value, Vector, Time Series
🔍 Multiple query languages: SQL, OpenCypher
⚡ High performance: Direct JVM integration via JPype
🔒 ACID transactions: Full transaction support
🎯 Vector storage: Store and query vector embeddings with HNSW (JVector) indexing
📥 Data import: Built-in CSV and ArcadeDB JSONL import

📦 What's Inside

The arcadedb-embedded package is platform-specific and self-contained:

Package Contents (current Linux x86_64 dev build; varies by platform and version):

Wheel size (compressed): ~67MB
ArcadeDB JARs (uncompressed): ~31MB across 63 JARs
Bundled JRE (uncompressed): ~63MB (platform-specific Java 25 runtime via jlink)
Installed package size: ~94MB

The compressed wheel size is measured from dist/*.whl, and the installed package size is measured from the extracted site-packages/arcadedb_embedded/ directory.

Of that, the optional server stack is 12 JARs, 7.65MB uncompressed, and it adds ~8MB to the wheel (the extra ~0.8MB beyond the JARs is JRE modules that only the server needs). Server Mode breaks the cost down and explains what you pay at runtime (nothing, until you start a server).

Note: Some JARs are excluded to optimize package size (e.g., gRPC wire protocol). See scripts/jar_exclusions.txt for details.

Import: import arcadedb_embedded as arcadedb

🧪 Testing

Status: 397 passed

Tests run against the built wheel via the uv project at the repo root — no virtualenv activation needed, and uv run works from anywhere in the repo:

# Run all tests
uv run pytest

# Run specific test file
uv run pytest tests/test_core.py -v

See testing documentation for detailed test documentation.

🔧 Building from Source (Advanced)

Linux uses Docker. macOS and Windows use a native Java 25+ JDK with jlink.

cd bindings/python/

# Install uv (one-time)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Build for your current platform (auto-detected)
./scripts/build.sh

Built wheels will be in dist/. The build script also refreshes the uv dev environment at the repo root, so uv run pytest immediately tests the wheel you just built.

Build instructions

Developer Note: See build architecture docs for comprehensive documentation of the multi-platform build architecture, including how we achieve platform-specific JRE bundling across the supported platforms on GitHub Actions.

Development

Versions are automatically extracted from the main ArcadeDB pom.xml. See versioning strategy for details on development vs release mode handling.

📋 Package Structure

arcadedb_embedded/
├── async_executor.py    # Asynchronous command/query + record execution
├── citation.py          # Citation helper
├── core.py              # Database and DatabaseFactory
├── exceptions.py        # ArcadeDBError exception
├── exporter.py          # Data export (JSONL, GraphML, GraphSON, CSV)
├── graph.py             # Graph wrappers
├── graph_batch.py       # GraphBatch high-throughput graph ingest wrapper
├── importer.py          # Data import (CSV, XML, ArcadeDB JSONL)
├── __init__.py          # Public API exports
├── jvm.py               # JVM lifecycle management
├── _logging.py          # Internal logging helpers
├── results.py           # ResultSet and Result wrappers
├── schema.py            # Schema management API
├── server.py            # ArcadeDBServer for optional HTTP/Studio mode
├── transactions.py      # TransactionContext manager
├── type_conversion.py   # Python-Java type conversion utilities
└── vector.py            # Vector search and HNSW (JVector) indexing

Architecture details

🤝 Contributing

See our contributing guidelines

📄 License

Both upstream ArcadeDB (Java) and this ArcadeDB Embedded Python project are licensed under Apache 2.0, fully open and free for everyone, including commercial use.

🔗 Links

Documentation: https://docs.humem.ai/arcadedb/latest/
PyPI: https://pypi.org/project/arcadedb-embedded/
GitHub: https://github.com/humemai/arcadedb-embedded-python
ArcadeDB Main Docs: https://docs.arcadedb.com
Issues: https://github.com/humemai/arcadedb-embedded-python/issues

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

arcadedb_embedded-26.8.1-cp314-cp314-win_amd64.whl (67.3 MB view details)

Uploaded Aug 3, 2026 CPython 3.14Windows x86-64

arcadedb_embedded-26.8.1-cp314-cp314-manylinux_2_34_x86_64.whl (70.4 MB view details)

Uploaded Aug 3, 2026 CPython 3.14manylinux: glibc 2.34+ x86-64

arcadedb_embedded-26.8.1-cp314-cp314-manylinux_2_34_aarch64.whl (69.3 MB view details)

Uploaded Aug 3, 2026 CPython 3.14manylinux: glibc 2.34+ ARM64

arcadedb_embedded-26.8.1-cp314-cp314-macosx_11_0_arm64.whl (65.7 MB view details)

Uploaded Aug 3, 2026 CPython 3.14macOS 11.0+ ARM64

arcadedb_embedded-26.8.1-cp313-cp313-win_amd64.whl (67.0 MB view details)

Uploaded Aug 3, 2026 CPython 3.13Windows x86-64

arcadedb_embedded-26.8.1-cp313-cp313-manylinux_2_34_x86_64.whl (70.4 MB view details)

Uploaded Aug 3, 2026 CPython 3.13manylinux: glibc 2.34+ x86-64

arcadedb_embedded-26.8.1-cp313-cp313-manylinux_2_34_aarch64.whl (69.3 MB view details)

Uploaded Aug 3, 2026 CPython 3.13manylinux: glibc 2.34+ ARM64

arcadedb_embedded-26.8.1-cp313-cp313-macosx_11_0_arm64.whl (65.7 MB view details)

Uploaded Aug 3, 2026 CPython 3.13macOS 11.0+ ARM64

arcadedb_embedded-26.8.1-cp312-cp312-win_amd64.whl (67.0 MB view details)

Uploaded Aug 3, 2026 CPython 3.12Windows x86-64

arcadedb_embedded-26.8.1-cp312-cp312-manylinux_2_34_x86_64.whl (70.4 MB view details)

Uploaded Aug 3, 2026 CPython 3.12manylinux: glibc 2.34+ x86-64

arcadedb_embedded-26.8.1-cp312-cp312-manylinux_2_34_aarch64.whl (69.3 MB view details)

Uploaded Aug 3, 2026 CPython 3.12manylinux: glibc 2.34+ ARM64

arcadedb_embedded-26.8.1-cp312-cp312-macosx_11_0_arm64.whl (65.7 MB view details)

Uploaded Aug 3, 2026 CPython 3.12macOS 11.0+ ARM64

arcadedb_embedded-26.8.1-cp311-cp311-win_amd64.whl (67.0 MB view details)

Uploaded Aug 3, 2026 CPython 3.11Windows x86-64

arcadedb_embedded-26.8.1-cp311-cp311-manylinux_2_34_x86_64.whl (70.4 MB view details)

Uploaded Aug 3, 2026 CPython 3.11manylinux: glibc 2.34+ x86-64

arcadedb_embedded-26.8.1-cp311-cp311-manylinux_2_34_aarch64.whl (69.3 MB view details)

Uploaded Aug 3, 2026 CPython 3.11manylinux: glibc 2.34+ ARM64

arcadedb_embedded-26.8.1-cp311-cp311-macosx_11_0_arm64.whl (65.7 MB view details)

Uploaded Aug 3, 2026 CPython 3.11macOS 11.0+ ARM64

arcadedb_embedded-26.8.1-cp310-cp310-win_amd64.whl (67.0 MB view details)

Uploaded Aug 3, 2026 CPython 3.10Windows x86-64

arcadedb_embedded-26.8.1-cp310-cp310-manylinux_2_34_x86_64.whl (70.4 MB view details)

Uploaded Aug 3, 2026 CPython 3.10manylinux: glibc 2.34+ x86-64

arcadedb_embedded-26.8.1-cp310-cp310-manylinux_2_34_aarch64.whl (69.3 MB view details)

Uploaded Aug 3, 2026 CPython 3.10manylinux: glibc 2.34+ ARM64

arcadedb_embedded-26.8.1-cp310-cp310-macosx_11_0_arm64.whl (65.7 MB view details)

Uploaded Aug 3, 2026 CPython 3.10macOS 11.0+ ARM64

File details

Details for the file arcadedb_embedded-26.8.1-cp314-cp314-win_amd64.whl.

File metadata

Download URL: arcadedb_embedded-26.8.1-cp314-cp314-win_amd64.whl
Upload date: Aug 3, 2026
Size: 67.3 MB
Tags: CPython 3.14, Windows x86-64
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for arcadedb_embedded-26.8.1-cp314-cp314-win_amd64.whl
Algorithm	Hash digest
SHA256	`0a86786e7083840333e8b1e0c19d1d398d357b35fb390c3ea07e844e7eb06939`
MD5	`83c6687f361aa01b27225676f5cdd7a9`
BLAKE2b-256	`fb7d901d87f8e5886f8f6ba51602711f715738d29bf89a11ff76cae558bdf5fd`

Algorithm	Hash digest
SHA256	`78020b66211dd7b449fe6b3256a499e5218e32b970b0b730a3d06b4a43a16c35`
MD5	`8046e952fe65ba484281d360e8e91e4b`
BLAKE2b-256	`fcc72f8c570515c324410aaa08a1d3730662ef34725f70a168a532bfa495496b`

Algorithm	Hash digest
SHA256	`7ebc82ba153cccacba9b4e12a8846b61bc89f847439e900ebcf6d4fd15d25ead`
MD5	`7794547bbb3c14159128f17ce853a57c`
BLAKE2b-256	`7ccc93d5e284bd6b2be0c4b90e4512dfd2b8dfe55c5c6512f5c0da1fc2bc2d61`

Algorithm	Hash digest
SHA256	`c6d33e502fcf10e2123f29c26bb5a4a1c43276b4cf8c2ecb05b71329ba0c1626`
MD5	`201b49f1b78eb31c51bf60fcf0e59c54`
BLAKE2b-256	`0afa2e4e52f0d7afa3ad32376819ec625ee388b7116bfcb8d8f2f6bf26298a3a`

Algorithm	Hash digest
SHA256	`59727efbaf2fb06351d786ae7e170fb62b2cf72611da8168c8dd2242a515d0bf`
MD5	`e27985491e1885b0e9f06837d913e7e1`
BLAKE2b-256	`ed17c0a58ae34b04da0097bb3d0286425ba3f3f777b60caef4d76d041d54bf99`

Algorithm	Hash digest
SHA256	`3f71d1d035e832eefe389367fd5e01198e369d1e2a2c706d0467d8070fb8180e`
MD5	`4d32a84d10501ce1f90c49865dfdb653`
BLAKE2b-256	`075e5404f52c0b966aaf2af57df43a9f5fdf5f989c36f8989b8efea084fec778`

Algorithm	Hash digest
SHA256	`3b0ad309c9c98ecd9947114631bf8e8ed22d89ee0bdb898de0cac69648ded926`
MD5	`ea904b09e9e532ece486a1307ac3dde6`
BLAKE2b-256	`cc1f25a701bc3200de4234462bbe55d01e985aec26f237c6b4311b8db34977f8`

Algorithm	Hash digest
SHA256	`24f985a7252e834b6367387f6fd363d66e40981b8d2729bd3b81ef257fd1ac39`
MD5	`542691f602bef37859c5fec487c57f7e`
BLAKE2b-256	`be1362e6cc4b96bebc4b95cdae5a38586e642c68bfe034e4216b5de703dbfd41`

Algorithm	Hash digest
SHA256	`fc13bb40fdebebe0e6df67f67cad2b951b7039d3e98e55ca953ce39703f2cb1b`
MD5	`af62bbd539e357fcd4efbde7e36e1a3c`
BLAKE2b-256	`44c7dd4c447a64a34a358012f32bb34eae8e88325bfb8266d0d90cde3b6a87e9`

Algorithm	Hash digest
SHA256	`d68411bcd6cb5f9737e89d0c2c5224dd2045f620094c5e2bc6c8a606a8aec4b5`
MD5	`33786546e7cdb571d4ac400a39ee8428`
BLAKE2b-256	`5cebe3d24e1124d51e56512e846ebda8c4a2651e052fe3e78e37baf7c7fb8871`

Algorithm	Hash digest
SHA256	`9722d5adca1205bf198dfbcc6f9cf594534d5f026d10846ad41cfe50a3061fb1`
MD5	`59a7d1f066b43fe388ebdfaf0e354052`
BLAKE2b-256	`90838cc2655b2d55deed02249d0af66eec6cebc2d7089becdbc0ff0c2b9621df`

Algorithm	Hash digest
SHA256	`c41721d0a097f9c16e82b511e02212cdce3e202008ed865f3ede6b62bc386776`
MD5	`2dc0b901d71ce73f855be0cb8dbba8d0`
BLAKE2b-256	`82dbbd5290f323c9630ee419a9dfb678a9dedda26b03e2e788e259b86eb03a0f`

Algorithm	Hash digest
SHA256	`a5172c662002a0636540a7a2b3dfcd1cc31e5585584de8d4ae4443784e111a1c`
MD5	`4eef91e294e4344016741866b0e4b963`
BLAKE2b-256	`fc5f9bb34e3d56b0bee6af205e801045a76d49d2726dc33300941ceaca76dfc4`

Algorithm	Hash digest
SHA256	`0bd9452a25b149aa307cf645bba99bb238eb97f7f12dd211ac230c0462895437`
MD5	`1226f083c6850fc396807f329af24c6d`
BLAKE2b-256	`191e6ce1a5fd7632a5036ebb926c2cae9f8ea099e51daec784e4d958467b60fd`

Algorithm	Hash digest
SHA256	`6f6aaef9a5f0a39f8e748146f751f083885547447b186a9a5b3744b7a043fc7e`
MD5	`7f1620b50f7e09d49be2f8f0a5c6bbaf`
BLAKE2b-256	`c9b97558ed56f0e6abafafa267ecc7f70d5da68629b0887bfaa654baf3120eb5`

Algorithm	Hash digest
SHA256	`2242c3d8f221199fc7f302e89f3cda0cbb8eae4becf9196c6fda1e8bdb00bd16`
MD5	`abf876888f7d84e66941352d676ea2c6`
BLAKE2b-256	`755cb948c2fce52a2035ec172010ad4a8c520d46ab140c0c5c258e84589feebd`

Algorithm	Hash digest
SHA256	`c918316708531f3b44b08515ce892649cda0b6af8a3f396c33db098ef8fc088f`
MD5	`8656d916214461be028c0b6556d7f393`
BLAKE2b-256	`9b0ca74e5c303b28405b2047aa90de2a3882d6c87b2c08ad63b33e9ab7197c23`

Algorithm	Hash digest
SHA256	`d55f9a1a5a1dceea1ba03cfdfc38a04dff0a0805bdddff0ef1acb725394fc6fe`
MD5	`5fd6c479db8cc94139e66216c95c259f`
BLAKE2b-256	`93ac7a867dc91c74e995539982c27809e8c584456fc8d750352fa69b7e23ebc6`

Algorithm	Hash digest
SHA256	`209601211385b2d5f6c9a237a3e45c430459d726effaecd742b5e8ab02a78536`
MD5	`68979023270d88ffa22c1493d4f09f64`
BLAKE2b-256	`6adab8dde16af3354d80fdf1a8bde1cfe1479e345220c448ee5f378dbf8667f6`

Algorithm	Hash digest
SHA256	`4291b4b4cc2dab923d4acd1f94dd551361f9a4c7930f695b21f7705271f41bd4`
MD5	`d8fd363266cb87456af7d1fd24db54c9`
BLAKE2b-256	`8100344055a14e8e8747e251599d0d4748f3f0e3afec75228e97117b814c7c24`

arcadedb-embedded 26.8.1

ArcadeDB Python Bindings

📚 Documentation

🚀 Quick Start

Installation

5-Minute Example

✨ Features

📦 What's Inside

🧪 Testing

🔧 Building from Source (Advanced)

Development

📋 Package Structure

🤝 Contributing

📄 License

🔗 Links

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distributions

Built Distributions

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance