oceanbase · Teingi · Apr 2, 2026 · Jan 27, 2026 · Jan 27, 2026 · Jan 28, 2026
diff --git a/.env.example b/.env.example
@@ -14,7 +14,7 @@ TIMEZONE=Asia/Shanghai
 # 1. Database Configuration (Required)
 # =============================================================================
 # Choose your database provider: sqlite, oceanbase, postgres
-DATABASE_PROVIDER=sqlite
+DATABASE_PROVIDER=oceanbase
 
 # -----------------------------------------------------------------------------
 # SQLite Configuration (Default - Recommended for development)
@@ -27,15 +27,17 @@ SQLITE_COLLECTION=memories
 # -----------------------------------------------------------------------------
 # OceanBase Configuration
 # -----------------------------------------------------------------------------
-OCEANBASE_HOST=127.0.0.1
+# Connection mode: set OCEANBASE_HOST for remote, leave empty for embedded SeekDB
+OCEANBASE_HOST=
+OCEANBASE_PATH=./seekdb_data
 OCEANBASE_PORT=2881
 OCEANBASE_USER=root@sys
 OCEANBASE_PASSWORD=your_password
 OCEANBASE_DATABASE=powermem
 OCEANBASE_COLLECTION=memories
 
 ## Keep the default settings, as modifications are generally not needed.
-OCEANBASE_INDEX_TYPE=IVF_FLAT
+OCEANBASE_INDEX_TYPE=HNSW
 OCEANBASE_VECTOR_METRIC_TYPE=cosine
 OCEANBASE_TEXT_FIELD=document
 OCEANBASE_VECTOR_FIELD=embedding

diff --git a/.github/workflows/build.yml b/.github/workflows/build.yml
@@ -12,10 +12,9 @@ on:
       python_version:
         description: 'Python version to build with'
         required: false
-        default: '3.10'
+        default: '3.11'
         type: choice
         options:
-          - '3.10'
           - '3.11'
           - '3.12'
 
@@ -53,7 +52,7 @@ jobs:
     needs: build-dashboard
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.11", "3.12"]
       fail-fast: false
 
     steps:

diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
@@ -36,7 +36,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v4
         with:
-          python-version: "3.10"
+          python-version: "3.11"
 
       - name: Inject Frontend and Build Package
         run: |

diff --git a/.github/workflows/regression.yml b/.github/workflows/regression.yml
@@ -36,7 +36,7 @@ jobs:
     if: github.event_name == 'push' || github.event_name == 'workflow_dispatch' || github.event_name == 'schedule' || (github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.full_name == github.repository)
     strategy:
       matrix:
-        python-version: ["3.10"]
+        python-version: ["3.11"]
       fail-fast: false
 
     steps:
@@ -174,7 +174,7 @@ jobs:
     if: github.event_name == 'push' || github.event_name == 'workflow_dispatch' || github.event_name == 'schedule' || (github.event_name == 'pull_request_target' && github.event.pull_request.head.repo.full_name == github.repository)
     strategy:
       matrix:
-        python-version: ["3.10"]
+        python-version: ["3.11"]
       fail-fast: false
 
     steps:

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -26,7 +26,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ["3.10", "3.11", "3.12"]
+        python-version: ["3.11", "3.12"]
       fail-fast: false
 
     steps:

diff --git a/README.md b/README.md
@@ -27,8 +27,8 @@ One command to add PowerMem memory to OpenClaw: `openclaw plugins install memory
     <a href="https://github.com/oceanbase/powermem/blob/master/LICENSE">
         <img alt="license" src="https://img.shields.io/badge/license-Apache%202.0-green.svg" />
     </a>
-    <a href="https://img.shields.io/badge/python%20-3.10.0%2B-blue.svg">
-        <img alt="pyversions" src="https://img.shields.io/badge/python%20-3.10.0%2B-blue.svg" />
+    <a href="https://img.shields.io/badge/python%20-3.11.0%2B-blue.svg">
+        <img alt="pyversions" src="https://img.shields.io/badge/python%20-3.11.0%2B-blue.svg" />
     </a>
     <a href="https://deepwiki.com/oceanbase/powermem">
         <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" />

diff --git a/README_CN.md b/README_CN.md
@@ -27,8 +27,8 @@
     <a href="https://github.com/oceanbase/powermem/blob/master/LICENSE">
         <img alt="license" src="https://img.shields.io/badge/license-Apache%202.0-green.svg" />
     </a>
-    <a href="https://img.shields.io/badge/python%20-3.10.0%2B-blue.svg">
-        <img alt="pyversions" src="https://img.shields.io/badge/python%20-3.10.0%2B-blue.svg" />
+    <a href="https://img.shields.io/badge/python%20-3.11.0%2B-blue.svg">
+        <img alt="pyversions" src="https://img.shields.io/badge/python%20-3.11.0%2B-blue.svg" />
     </a>
     <a href="https://deepwiki.com/oceanbase/powermem">
         <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" />

diff --git a/README_JP.md b/README_JP.md
@@ -27,8 +27,8 @@
     <a href="https://github.com/oceanbase/powermem/blob/master/LICENSE">
         <img alt="license" src="https://img.shields.io/badge/license-Apache%202.0-green.svg" />
     </a>
-    <a href="https://img.shields.io/badge/python%20-3.10.0%2B-blue.svg">
-        <img alt="pyversions" src="https://img.shields.io/badge/python%20-3.10.0%2B-blue.svg" />
+    <a href="https://img.shields.io/badge/python%20-3.11.0%2B-blue.svg">
+        <img alt="pyversions" src="https://img.shields.io/badge/python%20-3.11.0%2B-blue.svg" />
     </a>
     <a href="https://deepwiki.com/oceanbase/powermem">
         <img alt="Ask DeepWiki" src="https://deepwiki.com/badge.svg" />

diff --git a/benchmark/server/main.py b/benchmark/server/main.py
@@ -153,7 +153,7 @@ def create(self, *args: Any, **kwargs: Any) -> Any:
 app = FastAPI(
     title="PowerMem Benchmark REST APIs",
     description="A REST API for managing and searching memories for benchmark testing scenarios.",
-    version="1.0.0",
+    version="1.1.0",
     docs_url="/docs",
     redoc_url="/redoc",
 )

diff --git a/docs/api/0002-async_memory.md b/docs/api/0002-async_memory.md
@@ -263,16 +263,36 @@ async def batch_process():
 asyncio.run(batch_process())
 ```
 
+### Limitation: Embedded SeekDB Does Not Support Async
+
+Embedded SeekDB (local file mode with no `host` configured) uses a single-threaded C++ engine that **does not support concurrent multi-threaded access**. `AsyncMemory` internally submits synchronous operations to a `ThreadPoolExecutor`, which causes multiple threads to read and write the same embedded SeekDB instance simultaneously. This leads to C++-level crashes such as `pure virtual method called` or `Segmentation fault`.
+
+**`AsyncMemory` cannot be used with embedded SeekDB.** Use the synchronous `Memory` class instead.
+
+```python
+# ❌ Not supported with embedded SeekDB
+from powermem import AsyncMemory
+async_memory = AsyncMemory(config=embedded_seekdb_config)  # crashes
+
+# ✓ Use the synchronous interface with embedded SeekDB
+from powermem import Memory
+memory = Memory(config=embedded_seekdb_config)
+```
+
+Remote OceanBase (with `host` configured) is not affected by this limitation and fully supports `AsyncMemory`.
+
 ### When to Use AsyncMemory
 
 Use `AsyncMemory` when:
 - Processing many memories concurrently
 - Building async web applications (FastAPI, aiohttp)
 - Implementing batch processing pipelines
 - Need non-blocking memory operations
+- Using **remote OceanBase** (with `host` configured)
 
 Use `Memory` when:
 - Simple synchronous scripts
 - Interactive notebooks
 - Simple use cases without concurrency needs
+- Using **embedded SeekDB** (local file mode, no `host`)
 
diff --git a/docs/benchmark/overview.md b/docs/benchmark/overview.md
@@ -54,7 +54,7 @@ bash run.sh results
 
 ### Prerequisites
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - pip or poetry for dependency management
 - LLM and embedding API keys (OpenAI, Qwen, etc. — see root `.env.example`)
 - Database: OceanBase, PostgreSQL, or SQLite (depending on your configuration)
@@ -398,7 +398,7 @@ The benchmark evaluates performance using multiple metrics:
 - **Solution**: 
   - Install all dependencies: `pip install -r benchmark/locomo/requirements.txt`
   - Ensure you're running from the correct directory
-  - Check Python version (requires 3.10+)
+  - Check Python version (requires 3.11+)
 
 #### Slow performance
 - **Solution**: 

diff --git a/docs/development/overview.md b/docs/development/overview.md
@@ -25,7 +25,7 @@ This guide provides comprehensive instructions for developers who want to contri
 
 ### Prerequisites
 
-- Python 3.10 or higher
+- Python 3.11 or higher
 - pip (Python package manager)
 - Git
 

diff --git a/docs/examples/overview.md b/docs/examples/overview.md
@@ -67,7 +67,7 @@ Each notebook includes:
 
 ## Requirements
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Jupyter Notebook (for interactive notebooks)
 - LLM provider configured (for intelligent features in Scenario 2+)
diff --git a/docs/examples/scenario_10_sparse_vector.ipynb b/docs/examples/scenario_10_sparse_vector.ipynb
@@ -10,7 +10,7 @@
     "\n",
     "## Prerequisites\n",
     "\n",
-    "- Python 3.10+\n",
+    "- Python 3.11+\n",
     "- powermem installed (`pip install powermem`)\n",
     "- Database: **seekdb** or **OceanBase >= 4.5.0**\n"
    ]

diff --git a/docs/examples/scenario_10_sparse_vector.md b/docs/examples/scenario_10_sparse_vector.md
@@ -4,7 +4,7 @@ This example demonstrates how to use the sparse vector feature, including config
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Database: **seekdb** or **OceanBase >= 4.5.0**
 

diff --git a/docs/examples/scenario_1_basic_usage.ipynb b/docs/examples/scenario_1_basic_usage.ipynb
@@ -15,7 +15,7 @@
    "source": [
     "## Prerequisites\n",
     "\n",
-    "- Python 3.10+\n",
+    "- Python 3.11+\n",
     "- powermem installed (`pip install powermem`)\n"
    ]
   },

diff --git a/docs/examples/scenario_1_basic_usage.md b/docs/examples/scenario_1_basic_usage.md
@@ -4,7 +4,7 @@ This scenario guides you through the basics of powermem - storing, retrieving, a
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 
 ## Configuration

diff --git a/docs/examples/scenario_7_multimodal.ipynb b/docs/examples/scenario_7_multimodal.ipynb
@@ -17,7 +17,7 @@
    "source": [
     "## Prerequisites\n",
     "\n",
-    "- Python 3.10+\n",
+    "- Python 3.11+\n",
     "- powermem installed (`pip install powermem`)\n",
     "- Multimodal LLM API support\n"
    ]

diff --git a/docs/examples/scenario_7_multimodal.md b/docs/examples/scenario_7_multimodal.md
@@ -4,7 +4,7 @@ This scenario demonstrates PowerMem's multimodal capability - storing and retrie
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Multimodal LLM API support
 

diff --git a/docs/examples/scenario_8_ebbinghaus_forgetting_curve.ipynb b/docs/examples/scenario_8_ebbinghaus_forgetting_curve.ipynb
@@ -15,7 +15,7 @@
       "source": [
         "## Prerequisites\n",
         "\n",
-        "- Python 3.10+\n",
+        "- Python 3.11+\n",
         "- powermem installed (`pip install powermem`)\n",
         "- matplotlib and numpy for visualization (optional)\n"
       ]

diff --git a/docs/examples/scenario_8_ebbinghaus_forgetting_curve.md b/docs/examples/scenario_8_ebbinghaus_forgetting_curve.md
@@ -4,7 +4,7 @@ This scenario demonstrates how to implement and utilize the Ebbinghaus Forgettin
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - matplotlib and numpy for visualization (optional)
 

diff --git a/docs/examples/scenario_9_user_memory.ipynb b/docs/examples/scenario_9_user_memory.ipynb
@@ -11,7 +11,7 @@
     "\n",
     "## Prerequisites\n",
     "\n",
-    "- Python 3.10+\n",
+    "- Python 3.11+\n",
     "- powermem installed (`pip install powermem`)\n",
     "- LLM provider configured (for profile extraction)\n",
     "- OceanBase configured as vector store (UserMemory requires OceanBase)\n",

diff --git a/docs/examples/scenario_9_user_memory.md b/docs/examples/scenario_9_user_memory.md
@@ -4,7 +4,7 @@ This scenario demonstrates powermem's UserMemory feature - automatic user profil
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - LLM provider configured (for profile extraction)
 - OceanBase configured as vector store (UserMemory requires OceanBase)

diff --git a/docs/guides/0001-getting_started.md b/docs/guides/0001-getting_started.md
@@ -1,6 +1,6 @@
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 
 ## Configuration

diff --git a/docs/guides/0002-getting_started_async.md b/docs/guides/0002-getting_started_async.md
@@ -1,7 +1,7 @@
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Basic understanding of Python async/await syntax
 

diff --git a/docs/guides/0005-multi_agent.md b/docs/guides/0005-multi_agent.md
@@ -1,6 +1,6 @@
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Basic understanding of powermem (see [Getting Started Guide](./0001-getting_started.md))
 

diff --git a/docs/guides/0007-multimodal.md b/docs/guides/0007-multimodal.md
@@ -1,6 +1,6 @@
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Multimodal LLM API support
 

diff --git a/docs/guides/0008-ebbinghaus_forgetting_curve.md b/docs/guides/0008-ebbinghaus_forgetting_curve.md
@@ -1,6 +1,6 @@
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - matplotlib and numpy for visualization (optional)
 

diff --git a/docs/guides/0010-user_memory.md b/docs/guides/0010-user_memory.md
@@ -4,7 +4,7 @@ UserMemory is PowerMem's advanced user profile management module. It automatical
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - PowerMem installed (`pip install powermem`)
 - LLM and embedding services configured (for profile extraction)
 - Vector store configured (for storing memories and profiles)

diff --git a/docs/guides/0011-sparse_vector.md b/docs/guides/0011-sparse_vector.md
@@ -4,7 +4,7 @@ This guide explains how to use the Sparse Vector feature in PowerMem, including
 
 ## Prerequisites
 
-- Python 3.10+
+- Python 3.11+
 - powermem installed (`pip install powermem`)
 - Database requirements: **seekdb** or **OceanBase >= 4.5.0**
 

diff --git a/examples/langchain/README.md b/examples/langchain/README.md
@@ -40,7 +40,7 @@ This example demonstrates how to build an AI Healthcare Support Bot using **Powe
 
 ## Prerequisites
 
-1. **Python 3.10+**
+1. **Python 3.11+**
 2. **OceanBase Database** (configured and running)
 3. **API Keys**:
    - LLM API key (OpenAI, Qwen, etc.)

diff --git a/examples/langgraph/README.md b/examples/langgraph/README.md
@@ -40,7 +40,7 @@ This example demonstrates how to build an AI Customer Service Bot using **PowerM
 
 ## Prerequisites
 
-1. **Python 3.10+**
+1. **Python 3.11+**
 2. **OceanBase Database** (configured and running)
 3. **API Keys**:
    - LLM API key (OpenAI, Qwen, etc.)