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 Linux x86_64, Linux ARM64, and macOS Apple Silicon.
• Embedded usage (in-process) with optional server mode.
• 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, OpenCypher, and MongoDB query language.

📦 What the wheel includes

• Approximate size: ~74MB download, ~101-103MB 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, MongoDB.
• ACID transactions and high performance.

🚀 Quick start (Python)

uv 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 under Apache 2.0, fully open and free for everyone, including commercial use.