Skip to main content

OrbMem – A lightweight Cognitive Memory & Vector framework (Memory, Vectors, Graph, Safety).

Project description

OCDB — Cognitive Database Framework

OCDB (Orbynt Cognitive Database) is a lightweight, modular framework that combines 🧠 Memory, 🔍 Vector Search, 🕸 Graph Reasoning, and 🛡 Safety Scanning into a single Python package.

Designed for:

  • AI agents
  • Chatbots
  • Automation systems
  • Reasoning pipelines
  • Personal assistants
  • Any system that needs context, memory, search, and safety

This is the local developer version for PyPI. A fully hosted OCDB Cloud Platform will launch separately.


✨ Features

🧠 1. Memory Engine

Store and retrieve structured memory using a simple API.

from ocdb.core.ocdb import OCDB

ocdb = OCDB()
ocdb.memory_set("name", {"value": "Abhishek"})
print(ocdb.memory_get("name"))

🔍 2. Vector Search (FAISS local engine)

Semantic search powered by FAISS.

ocdb.vector_engine.add_text("hello world", {"id": "1"})
results = ocdb.vector_search("hello", k=3)

🕸 3. Graph Engine (NetworkX)

Build reasoning trees or node-based logic.

ocdb.graph_add("root", "Start")
ocdb.graph_add("child", "Next", parent="root")

🛡 4. Safety Engine

Simple text-safety scanning with MongoDB + time-series tracking.

events = ocdb.safety_scan("This is a sample text")

📦 Installation

pip install orbmem

📁 Project Structure

ocdb/
 ├── core/        # Config, auth, high-level OCDB interface
 ├── engines/     # Memory, vector, graph, safety engines
 ├── models/      # Memory & safety models
 ├── utils/       # Helpers, exceptions, logging
 └── db/          # Database connectors (Mongo, Neo4j, Postgres, Redis)

🚀 Quickstart Example

from ocdb.core.ocdb import OCDB

ocdb = OCDB()

# Memory
ocdb.memory_set("demo", {"text": "Hello OCDB"})
print(ocdb.memory_get("demo"))

# Vector
ocdb.vector_engine.add_text("Abhishek is building OCDB", {"id": "vec1"})
print(ocdb.vector_search("Abhishek"))

# Graph
ocdb.graph_add("n1", "Start")
ocdb.graph_add("n2", "Next", parent="n1")

# Safety
print(ocdb.safety_scan("Harmless text"))

📝license

This project is released under the MIT License.
See the LICENSE file for full terms.


👨‍💻 Author

Tetala Lakshmi Abhishek Reddy
Creator of OCDB
📧Email: abhishek.orbynt@gmail.com


⭐ Support OCDB

f you like this project, please star the repository and share it!
The OCDB Cloud Dashboard + Hosted API is coming soon… 🚀

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

orbmem-1.0.5.tar.gz (18.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

orbmem-1.0.5-py3-none-any.whl (23.3 kB view details)

Uploaded Python 3

File details

Details for the file orbmem-1.0.5.tar.gz.

File metadata

  • Download URL: orbmem-1.0.5.tar.gz
  • Upload date:
  • Size: 18.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for orbmem-1.0.5.tar.gz
Algorithm Hash digest
SHA256 10ad2a30995d97557b29baf0ae81e8364a8d278af19eabd616765dbd54325b54
MD5 a95292b8270835028a662f8c69846212
BLAKE2b-256 1ae66860c78ebf41cfa2f2f43276f4dd47c132a9f4087bf11a84f299e6d15e53

See more details on using hashes here.

File details

Details for the file orbmem-1.0.5-py3-none-any.whl.

File metadata

  • Download URL: orbmem-1.0.5-py3-none-any.whl
  • Upload date:
  • Size: 23.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.2

File hashes

Hashes for orbmem-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c81888eed9df3ba8bbe18e156a5122f1af00c5563c7fcbe297b69c860b601274
MD5 22f1c91a6166c790234c057dbd6257d1
BLAKE2b-256 fa464a0f7bf2ca84fdcb3c8d2bb59c2889baa971f1233ef0a4e26632623a67b6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page