---
id: python-arango
version: "8.3.3"
license: MIT License Copyright (c) 2016-2021 Joohwan Oh Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record)
license_treatment: permissive
maintenance: active
---

# python-arango — Python Driver for ArangoDB

License: permissive · Maintenance: active · Downloads: 7.2M/mo

## What it is and what it does

Python-Arango is the official synchronous Python driver for ArangoDB, a multi-model database supporting documents, graphs, and search. It handles connection management, database and collection operations, document CRUD, graph traversal, and AQL query execution through a high-level API. The driver abstracts HTTP communication with ArangoDB's REST endpoints, managing authentication and result streaming through cursor objects.

Typical workflows involve initializing an ArangoClient with a host URL, authenticating to a database, creating or accessing collections, inserting or querying documents, and executing AQL queries. The package also supports graph operations—creating vertex and edge collections, defining relationships, and traversing graphs. For async workloads, the documentation directs users to python-arango-async instead.

Use it for:

- Build document-oriented applications with schema-flexible storage and persistent indexing on collections
- Model and query graph relationships (e.g., social networks, knowledge graphs) using vertex and edge collections
- Execute complex multi-document transactions and aggregations via AQL queries across large datasets
- Migrate from or integrate with ArangoDB in Python backends without writing raw HTTP calls
- Prototype or develop applications that require multi-model capabilities in a single database

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python driver for ArangoDB that provides synchronous access to document, graph, and search operations across ArangoDB's multi-model database.

Yes. The package is actively maintained, has low install friction, carries a permissive MIT license, and is the official driver for ArangoDB. Install it if you are building against ArangoDB 3.11+ and need synchronous Python access to documents, graphs, or search. If your workload requires async I/O, use python-arango-async instead. No known security vulnerabilities.

## Install

pip install python-arango
uv add python-arango
poetry add python-arango

## Installing python-arango

Before you install: Low install friction with a pure-Python wheel distribution. Actively maintained with a recent release (74 days ago) and steady repository activity. Requires Python 3.10 or later and ArangoDB 3.11+.

License in practice: MIT License permits free use, modification, and distribution with minimal restrictions. Copyright held by original authors (2016-2021); suitable for both commercial and open-source projects.

Quickstart:

pip install python-arango

from arango import ArangoClient

client = ArangoClient(hosts="http://localhost:8529")
db = client.db("test", username="root", password="passwd")
students = db.create_collection("students")
students.insert({"name": "jane", "age": 39})
cursor = db.aql.execute("FOR doc IN students RETURN doc")

Requires ArangoDB 3.11+ running and accessible at the specified host; Python 3.10 or later.

Verify before relying:

- Performance characteristics under high concurrency or large result sets
- Completeness of ArangoDB feature coverage across different database versions
- Real-world usage patterns and adoption beyond the top-5000 PyPI tier

## Package facts

- License: MIT License Copyright (c) 2016-2021 Joohwan Oh Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to… (full text in the JSON record) (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 7.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

arangodb python driver, arangodb client library, graph database python, document database driver, arangodb query execution, multi-model database python, arangodb collection management, database-driver, graph-database, multi-model

[View on SkillFed](https://skillfed.io/packages/python-arango) · [View on PyPI](https://pypi.org/project/python-arango/)