Refactor Python bindings to replace Gremlin with OpenCypher support

- Added benchmark results for Gremlin vs OpenCypher vs SQL in markdown format.
- Updated jar exclusions to remove unnecessary Gremlin dependencies.
- Introduced a script to list JARs by size from the latest ArcadeDB Docker image.
- Modified mkdocs configuration to reflect OpenCypher queries instead of Gremlin.
- Adjusted vector index parameters in core.py for better performance and defaults.
- Updated exporter.py to clarify GraphML and GraphSON support requirements.
- Revised tests to remove Gremlin references and replace them with OpenCypher tests.
- Removed deprecated Gremlin tests and ensured all documentation reflects OpenCypher usage.
- Updated plan documentation to outline the transition from Gremlin to OpenCypher.

Author: tae898

bindings/python/README.md

@@ -77,7 +77,7 @@ with arcadedb.create_database("./mydb") as db:
 - 🌐 **Server Mode**: Optional HTTP server with Studio web interface
 - 📦 **Self-contained**: All dependencies bundled (~209-215MB wheel)
 - 🔄 **Multi-model**: Graph, Document, Key/Value, Vector, Time Series
-- 🔍 **Multiple query languages**: SQL, Cypher, Gremlin, MongoDB
+- 🔍 **Multiple query languages**: SQL, OpenCypher, MongoDB
 - ⚡ **High performance**: Direct JVM integration via JPype
 - 🔒 **ACID transactions**: Full transaction support
 - 🎯 **Vector storage**: Store and query vector embeddings with HNSW (JVector) indexing

bindings/python/docs/api/database.md

@@ -131,7 +131,7 @@ Execute a query and return results. Queries are read-only and don't require a tr
 
 **Parameters:**
 
-- `language` (str): Query language - `"sql"`, `"cypher"`, `"gremlin"`, `"mongo"`, `"graphql"`
+- `language` (str): Query language - `"sql"`, `"opencypher"`, `"mongo"`, `"graphql"`
 - `command` (str): Query string
 - `*args`: Optional parameters to bind to the query
 
@@ -154,8 +154,8 @@ for record in result:
 # Parameterized query
 result = db.query("sql", "SELECT FROM Person WHERE age > ?", 25)
 
-# Cypher query
-result = db.query("cypher", """
+# OpenCypher query
+result = db.query("opencypher", """
     MATCH (p:Person)-[:Knows]->(friend)
     WHERE p.age > $min_age
     RETURN friend.name
@@ -167,9 +167,8 @@ result = db.query("cypher", """
 | Language | Notes |
 |----------|-------|
 | `sql` | ArcadeDB SQL |
-| `cypher` | OpenCypher graph query language |
+| `opencypher` | OpenCypher graph query language |
 | `mongo` | MongoDB query syntax |
-| `gremlin` | Apache TinkerPop traversal |
 | `graphql` | GraphQL queries |
 
 ---
@@ -184,7 +183,7 @@ Execute a command (write operation). Commands modify data and **require a transa
 
 **Parameters:**
 
-- `language` (str): Command language (usually `"sql"` or `"cypher"`)
+- `language` (str): Command language (usually `"sql"` or `"opencypher"`)
 - `command` (str): Command string
 - `*args`: Optional parameters
 
@@ -774,30 +773,18 @@ db.query("sql", "SELECT expand(out('Knows')) FROM Person WHERE name = 'Alice'")
 db.query("sql", "SELECT count(*) as total, avg(age) as avg_age FROM Person")
 ```
 
-### Cypher
+### OpenCypher
 
 OpenCypher graph query language:
 
 ```python
-db.query("cypher", """
+db.query("opencypher", """
     MATCH (person:Person)-[:Knows]->(friend)
     WHERE person.age > 25
     RETURN friend.name, friend.age
 """)
 ```
 
-### Gremlin
-
-Apache TinkerPop graph traversals:
-
-```python
-db.query("gremlin", """
-    g.V().has('Person', 'name', 'Alice')
-        .out('Knows')
-        .values('name')
-""")
-```
-
 ---
 
 ## Best Practices

bindings/python/docs/api/exceptions.md

@@ -67,7 +67,7 @@ except ArcadeDBError as e:
     # Query error: ... syntax error near 'SELCT'
 ```
 
-**Solution:** Check query syntax, use proper SQL/Cypher/Gremlin.
+**Solution:** Check query syntax, use proper SQL/OpenCypher.
 
 ---
 

bindings/python/docs/api/server.md

@@ -10,15 +10,15 @@ The server provides:
 - **Studio Web UI**: Visual database exploration and query editor
 - **Multi-database Management**: Create and access multiple databases
 - **Remote Access**: Access from other applications via HTTP
-- **GraphQL/Gremlin Support**: Extended query languages
+- **GraphQL/OpenCypher Support**: Extended query languages
 
 **When to Use Server Mode:**
 
 - Interactive development and debugging
 - Web applications needing HTTP API
 - Visual data exploration via Studio
 - Remote database access
-- GraphQL or Gremlin queries
+- GraphQL or OpenCypher queries
 
 **When to Use Embedded Mode:**
 

bindings/python/docs/development/architecture.md

@@ -500,7 +500,7 @@ The Python binding is distributed as a **single, self-contained package** (`arca
 **Features:**
 
 - **Bundled JRE**: Includes a minimal Java 21 Runtime Environment (JRE) via the `arcadedb-embedded-jre` package.
-- **Full Feature Set**: Includes all ArcadeDB engines (SQL, Cypher, Gremlin, GraphQL, MongoDB).
+- **Full Feature Set**: Includes all ArcadeDB engines (SQL, OpenCypher, GraphQL, MongoDB).
 - **Zero Configuration**: No external Java installation required.
 
 ```python
@@ -509,8 +509,7 @@ import arcadedb_embedded as arcadedb
 
 db = arcadedb.create_database("./mydb")
 db.query("sql", "SELECT FROM User")              # ✓
-db.query("cypher", "MATCH (n) RETURN n")         # ✓
-db.query("gremlin", "g.V()")                     # ✓
+db.query("opencypher", "MATCH (n) RETURN n")     # ✓
 db.query("graphql", "{users{name}}")             # ✓
 db.query("mongodb", "db.User.find()")            # ✓
 ```
@@ -673,7 +672,7 @@ def download_arcadedb_jars(version):
     jar_url = f"{base_url}arcadedb/{version}/arcadedb-{version}.jar"
     download_jar(jar_url, f"arcadedb-{version}.jar")
 
-    # Download all dependencies (Gremlin, GraphQL, etc.)
+    # Download all dependencies (GraphQL, etc.)
     pass
 
 # Called during package build

bindings/python/docs/development/contributing.md

@@ -115,7 +115,7 @@ arcadedb/bindings/python/
 │   ├── test_exporter.py           # Exporter tests
 │   ├── test_vector.py             # Vector search tests
 │   ├── test_vector_sql.py         # Vector SQL tests
-│   ├── test_gremlin.py            # Gremlin tests
+│   ├── test_cypher.py             # OpenCypher tests
 │   ├── test_batch_context.py      # Batch operations tests
 │   ├── test_async_executor.py     # Async execution tests
 │   ├── test_type_conversion.py    # Type conversion tests
@@ -224,8 +224,8 @@ pytest tests/test_server.py
 # Importer
 pytest tests/test_importer.py
 
-# Gremlin tests
-pytest tests/test_gremlin.py -m gremlin
+# OpenCypher tests
+pytest tests/test_cypher.py -k cypher
 ```
 
 ### Test Markers
@@ -234,11 +234,8 @@ pytest tests/test_gremlin.py -m gremlin
 # Skip server tests
 pytest -m "not server"
 
-# Only Gremlin tests
-pytest -m gremlin
-
-# Skip Gremlin tests
-pytest -m "not gremlin"
+# Only OpenCypher tests
+pytest -k cypher
 ```
 
 ### Writing Tests
@@ -513,7 +510,7 @@ class Database:
         Execute a query and return results.
 
         Args:
-            language: Query language (sql, cypher, gremlin, etc.)
+            language: Query language (sql, opencypher, mongo, graphql, etc.)
             command: Query command string
             params: Optional query parameters
 
@@ -543,7 +540,7 @@ Execute a query and return results.
 
 **Parameters:**
 
-- `language` (str): Query language (sql, cypher, gremlin, mongodb, graphql)
+- `language` (str): Query language (sql, opencypher, mongodb, graphql)
 - `command` (str): Query command string
 - `params` (Optional[dict]): Query parameters for parameterized queries
 

bindings/python/docs/development/documentation.md

@@ -222,7 +222,7 @@ db.close()
 | Feature | Current Package | Notes |
 |---------|----------------|--------|
 | SQL | ✅ Yes | All SQL features |
-| Gremlin | ✅ Yes | Graph queries |
+| OpenCypher | ✅ Yes | Graph queries |
 | Studio UI | ✅ Yes | Web interface |
 ```
 

bindings/python/docs/development/testing.md

@@ -6,7 +6,7 @@ Comprehensive testing documentation for ArcadeDB Python bindings.
     **222 tests** across 6 test files, 100% passing
 
     - **Current package**: 222 passed, 0 skipped
-    - All ArcadeDB features working (SQL, Cypher, Gremlin, Studio)
+    - All ArcadeDB features working (SQL, OpenCypher, Studio)
 
 ## Quick Navigation
 
@@ -48,7 +48,7 @@ Comprehensive testing documentation for ArcadeDB Python bindings.
 
     CSV import with type inference (16 tests)
 
--   :material-graph: **[Gremlin Tests](testing/test-gremlin.md)**
+-   :material-graph: **[OpenCypher Tests](testing/test-opencypher.md)**
 
     ---
 
@@ -94,7 +94,7 @@ pytest --cov=arcadedb_embedded --cov-report=html
 | **Concurrency** | File locking, thread safety, multi-process limitations |
 | **Server Patterns** | Embedded+HTTP combinations, lock management |
 | **Data Import** | CSV with type inference, batch commits |
-| **Query Languages** | SQL, Cypher, Gremlin |
+| **Query Languages** | SQL, OpenCypher |
 | **Advanced Features** | Unicode support, schema introspection, large datasets |
 
 ## Key Concepts
@@ -155,7 +155,7 @@ tests/
 ├── test_concurrency.py       # Concurrency (4 tests)
 ├── test_server_patterns.py   # Patterns (4 tests)
 ├── test_importer.py          # Import (13 tests)
-├── test_gremlin.py           # Gremlin (1 test)
+├── test_cypher.py            # OpenCypher (tests)
 └── conftest.py               # Shared fixtures
 ```
 

bindings/python/docs/development/testing/overview.md

@@ -6,7 +6,7 @@ The ArcadeDB Python bindings have a comprehensive test suite covering all major
 
 !!! success "Test Results"
     - **Current package**: ✅ 222 passed, 0 skipped
-    - All features available (SQL, Cypher, Gremlin, Studio UI, Vector search)
+    - All features available (SQL, OpenCypher, Studio UI, Vector search)
 
     **Total: 222 tests + 7 examples** across all platforms, 100% passing
 
@@ -18,7 +18,7 @@ The test suite covers:
 - ✅ **Server mode** - HTTP API, multi-client access
 - ✅ **Concurrency patterns** - File locking, thread safety, multi-process
 - ✅ **Graph operations** - Vertices, edges, traversals
-- ✅ **Query languages** - SQL, Cypher, Gremlin
+- ✅ **Query languages** - SQL, OpenCypher
 - ✅ **Vector search** - HNSW (JVector) based Vector indexes, similarity search
 - ✅ **Data import** - CSV with batch commits and type inference
 - ✅ **Unicode support** - International characters, emoji
@@ -74,7 +74,7 @@ pytest -v -s
 | [`test_concurrency.py`](test-concurrency.md) | 4 | File locking, thread safety, multi-process behavior |
 | [`test_server_patterns.py`](test-server-patterns.md) | 4 | Best practices for embedded + server mode |
 | [`test_importer.py`](test-importer.md) | 16 | CSV import with type inference |
-| [`test_gremlin.py`](test-gremlin.md) | 1 | Gremlin query language (if available) |
+| [`test_cypher.py`](test-opencypher.md) | 1 | OpenCypher query language |
 
 ## Common Testing Workflows
 
@@ -115,8 +115,8 @@ Tests are organized with pytest markers:
 # Run only server tests
 pytest -m server
 
-# Run only Gremlin tests
-pytest -m gremlin
+# Run only OpenCypher tests
+pytest -k cypher
 
 # Run all except slow tests
 pytest -m "not slow"
@@ -138,7 +138,7 @@ When all tests pass, you should see:
 - **Using server mode?** See [Server Tests](test-server.md) and [Server Patterns](test-server-patterns.md)
 - **Confused about concurrency?** Read [Concurrency Tests](test-concurrency.md)
 - **Importing data?** Check [Data Import Tests](test-importer.md)
-- **Using Gremlin?** See [Gremlin Tests](test-gremlin.md)
+- **Using OpenCypher?** See [OpenCypher Tests](test-opencypher.md)
 
 ## Related Documentation
 

bindings/python/docs/development/testing/test-core.md

@@ -14,7 +14,7 @@ Tests validate:
 - Graph operations (vertex/edge creation and traversal)
 - Query result handling and iteration
 - Error handling
-- Cypher queries (when available)
+- OpenCypher queries (when available)
 - Vector search with HNSW indexes
 - Unicode/international character support
 - Schema introspection and metadata
@@ -46,9 +46,8 @@ Tests validate:
 
 ### Query Languages
 
-- **cypher_queries**: Tests Cypher CREATE statements, MATCH queries, property access (when Cypher available)
+- **cypher_queries**: Tests OpenCypher CREATE statements, MATCH queries, property access (when OpenCypher available)
 - **sql_queries**: Tests SQL queries, aggregation, filtering, joins
-- **gremlin_queries**: Tests Gremlin traversal queries (when available)
 
 ### Advanced Features