ArcadeDB Embedded for Python

Native Python bindings for ArcadeDB (forked from the official Java project).

---

✨ What this repo provides

• Native Python bindings for ArcadeDB with a bundled JRE (no local Java required).
• Wheels for 4 platforms: Linux x86_64, Linux ARM64, macOS Apple Silicon, and Windows x86_64.
• Embedded usage (in-process) with optional in-process server mode (HTTP API + Studio).
• Tests and examples validated in CI across supported platforms.

The Python bindings and packaging live under bindings/python. The upstream Java project remains the source of the core database.

🧱 What’s inside

• bindings/python: Python package source, build scripts, tests, and examples.
• docs site: https://docs.humem.ai/arcadedb/
• CI: Build/test workflows for bindings and examples (badges above).

✅ Typical use cases

• Local embedded analytics without a separate server process.
• Vector search and graph workloads from Python.
• Running ArcadeDB in-process for testing or tooling.

🧠 ArcadeDB at a glance

• Multi-model database built for performance.
• Document + Graph + Key/Value + Vector + Time Series in one engine.
• Supports SQL and OpenCypher query languages.

📦 What the wheel includes

• Approximate size: ~62MB download, ~87MB installed.
• Lightweight Java 25 runtime (jlink) bundled per platform.
• ArcadeDB JARs required for the embedded engine.
• Python bindings and source modules.

✨ ArcadeDB capabilities (via Python)

• Multi-model: Graph, Document, Key/Value, Vector, Time Series.
• Query languages: SQL, OpenCypher.
• ACID transactions and high performance.

🚀 Quick start (Python)

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

🔗 Quick Links

• Python README: bindings/python/README.md
• PyPI: https://pypi.org/project/arcadedb-embedded/

🧭 Upstream ArcadeDB (Java)

This repo is a fork of ArcadeDB Java. For the server, Java API, and core database docs:

• Upstream repo: https://github.com/ArcadeData/arcadedb
• Docs: https://docs.arcadedb.com

💬 Support & community

• Issues (Python bindings): https://github.com/humemai/arcadedb-embedded-python/issues
• ArcadeDB Discord: https://discord.gg/w2Npx2B7hZ

📄 License

Both upstream ArcadeDB (Java) and this ArcadeDB Embedded Python project are licensed

Arcade Data, the company behind ArcadeDB, has committed in writing to keeping the engine Apache 2.0, and HumemAI, the company behind this package, makes the same commitment for the Python bindings. under Apache 2.0, fully open and free for everyone, including commercial use.