{"id":13795433,"url":"https://github.com/arangodb/python-arango","last_synced_at":"2026-04-02T18:45:48.185Z","repository":{"id":17206803,"uuid":"19975250","full_name":"arangodb/python-arango","owner":"arangodb","description":"The official ArangoDB Python driver.","archived":false,"fork":false,"pushed_at":"2026-03-23T06:00:44.000Z","size":1602,"stargazers_count":468,"open_issues_count":0,"forks_count":79,"subscribers_count":10,"default_branch":"main","last_synced_at":"2026-03-24T02:02:01.351Z","etag":null,"topics":["arangodb","arangodb-client","arangodb-driver","python"],"latest_commit_sha":null,"homepage":"https://docs.python-arango.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arangodb.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-05-20T09:28:59.000Z","updated_at":"2026-03-23T05:48:05.000Z","dependencies_parsed_at":"2023-09-22T22:49:40.120Z","dependency_job_id":"d326f66a-915d-44f0-a4f6-b89cf9c960e5","html_url":"https://github.com/arangodb/python-arango","commit_stats":{"total_commits":279,"total_committers":37,"mean_commits":7.54054054054054,"dds":0.7025089605734767,"last_synced_commit":"542ed5b133db0ccc386cfe75897058a4dee1c06b"},"previous_names":["arangodb/python-arango","arangodb-community/python-arango","joowani/python-arango","joowani/py-arango"],"tags_count":88,"template":false,"template_full_name":null,"purl":"pkg:github/arangodb/python-arango","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arangodb%2Fpython-arango","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arangodb%2Fpython-arango/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arangodb%2Fpython-arango/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arangodb%2Fpython-arango/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arangodb","download_url":"https://codeload.github.com/arangodb/python-arango/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arangodb%2Fpython-arango/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31313309,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arangodb","arangodb-client","arangodb-driver","python"],"created_at":"2024-08-03T23:00:56.746Z","updated_at":"2026-04-02T18:45:48.178Z","avatar_url":"https://github.com/arangodb.png","language":"Python","readme":"![Logo](https://user-images.githubusercontent.com/2701938/108583516-c3576680-72ee-11eb-883f-2d9b52e74e45.png)\n\n[![CircleCI](https://dl.circleci.com/status-badge/img/gh/arangodb/python-arango/tree/main.svg?style=svg)](https://dl.circleci.com/status-badge/redirect/gh/arangodb/python-arango/tree/main)\n[![CodeQL](https://github.com/arangodb/python-arango/actions/workflows/codeql.yaml/badge.svg)](https://github.com/arangodb/python-arango/actions/workflows/codeql.yaml)\n[![Docs](https://github.com/arangodb/python-arango/actions/workflows/docs.yaml/badge.svg)](https://github.com/arangodb/python-arango/actions/workflows/docs.yaml)\n[![Coverage Status](https://codecov.io/gh/arangodb/python-arango/branch/main/graph/badge.svg?token=M8zrjrzsUY)](https://codecov.io/gh/arangodb/python-arango)\n[![Last commit](https://img.shields.io/github/last-commit/arangodb/python-arango)](https://github.com/arangodb/python-arango/commits/main)\n\n[![PyPI version badge](https://img.shields.io/pypi/v/python-arango?color=3775A9\u0026style=for-the-badge\u0026logo=pypi\u0026logoColor=FFD43B)](https://pypi.org/project/python-arango/)\n[![Python versions badge](https://img.shields.io/badge/3.9%2B-3776AB?style=for-the-badge\u0026logo=python\u0026logoColor=FFD43B\u0026label=Python)](https://pypi.org/project/python-arango/)\n\n[![License](https://img.shields.io/github/license/arangodb/python-arango?color=9E2165\u0026style=for-the-badge)](https://github.com/arangodb/python-arango/blob/main/LICENSE)\n[![Code style: black](https://img.shields.io/static/v1?style=for-the-badge\u0026label=code%20style\u0026message=black\u0026color=black)](https://github.com/psf/black)\n[![Downloads](https://img.shields.io/pepy/dt/python-arango?style=for-the-badge\u0026color=282661\n)](https://pepy.tech/project/python-arango)\n\n# Python-Arango\n\nPython driver for [ArangoDB](https://www.arangodb.com), a scalable multi-model\ndatabase natively supporting documents, graphs and search.\n\nIf you're interested in using asyncio, please check [python-arango-async](https://github.com/arangodb/python-arango-async).\n\n## Requirements\n\n- ArangoDB version 3.11+\n- Python version 3.9+\n\n## Installation\n\n```shell\npip install python-arango --upgrade\n```\n\n## Getting Started\n\nHere is a simple usage example:\n\n```python\nfrom arango import ArangoClient\n\n# Initialize the client for ArangoDB.\nclient = ArangoClient(hosts=\"http://localhost:8529\")\n\n# Connect to \"_system\" database as root user.\nsys_db = client.db(\"_system\", username=\"root\", password=\"passwd\")\n\n# Create a new database named \"test\".\nsys_db.create_database(\"test\")\n\n# Connect to \"test\" database as root user.\ndb = client.db(\"test\", username=\"root\", password=\"passwd\")\n\n# Create a new collection named \"students\".\nstudents = db.create_collection(\"students\")\n\n# Add a persistent index to the collection.\nstudents.add_index({'type': 'persistent', 'fields': ['name'], 'unique': True})\n\n# Insert new documents into the collection.\nstudents.insert({\"name\": \"jane\", \"age\": 39})\nstudents.insert({\"name\": \"josh\", \"age\": 18})\nstudents.insert({\"name\": \"judy\", \"age\": 21})\n\n# Execute an AQL query and iterate through the result cursor.\ncursor = db.aql.execute(\"FOR doc IN students RETURN doc\")\nstudent_names = [document[\"name\"] for document in cursor]\n```\n\nAnother example with [graphs](https://docs.arangodb.com/stable/graphs/):\n\n```python\nfrom arango import ArangoClient\n\n# Initialize the client for ArangoDB.\nclient = ArangoClient(hosts=\"http://localhost:8529\")\n\n# Connect to \"test\" database as root user.\ndb = client.db(\"test\", username=\"root\", password=\"passwd\")\n\n# Create a new graph named \"school\".\ngraph = db.create_graph(\"school\")\n\n# Create a new EnterpriseGraph [Enterprise Edition]\neegraph = db.create_graph(\n    name=\"school\",\n    smart=True)\n\n# Create vertex collections for the graph.\nstudents = graph.create_vertex_collection(\"students\")\nlectures = graph.create_vertex_collection(\"lectures\")\n\n# Create an edge definition (relation) for the graph.\nedges = graph.create_edge_definition(\n    edge_collection=\"register\",\n    from_vertex_collections=[\"students\"],\n    to_vertex_collections=[\"lectures\"]\n)\n\n# Insert vertex documents into \"students\" (from) vertex collection.\nstudents.insert({\"_key\": \"01\", \"full_name\": \"Anna Smith\"})\nstudents.insert({\"_key\": \"02\", \"full_name\": \"Jake Clark\"})\nstudents.insert({\"_key\": \"03\", \"full_name\": \"Lisa Jones\"})\n\n# Insert vertex documents into \"lectures\" (to) vertex collection.\nlectures.insert({\"_key\": \"MAT101\", \"title\": \"Calculus\"})\nlectures.insert({\"_key\": \"STA101\", \"title\": \"Statistics\"})\nlectures.insert({\"_key\": \"CSC101\", \"title\": \"Algorithms\"})\n\n# Insert edge documents into \"register\" edge collection.\nedges.insert({\"_from\": \"students/01\", \"_to\": \"lectures/MAT101\"})\nedges.insert({\"_from\": \"students/01\", \"_to\": \"lectures/STA101\"})\nedges.insert({\"_from\": \"students/01\", \"_to\": \"lectures/CSC101\"})\nedges.insert({\"_from\": \"students/02\", \"_to\": \"lectures/MAT101\"})\nedges.insert({\"_from\": \"students/02\", \"_to\": \"lectures/STA101\"})\nedges.insert({\"_from\": \"students/03\", \"_to\": \"lectures/CSC101\"})\n\n# Traverse the graph in outbound direction, breath-first.\nquery = \"\"\"\n    FOR v, e, p IN 1..3 OUTBOUND 'students/01' GRAPH 'school'\n    OPTIONS { bfs: true, uniqueVertices: 'global' }\n    RETURN {vertex: v, edge: e, path: p}\n    \"\"\"\ncursor = db.aql.execute(query)\n```\n\nPlease see the [documentation](https://docs.python-arango.com) for more details.\n","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farangodb%2Fpython-arango","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farangodb%2Fpython-arango","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farangodb%2Fpython-arango/lists"}