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.6.tar.gz (18.3 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.6-py3-none-any.whl (23.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: orbmem-1.0.6.tar.gz
  • Upload date:
  • Size: 18.3 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.6.tar.gz
Algorithm Hash digest
SHA256 aaae86733414ec4094e12dd39225ed5a9f6f2a2ac37b6a3edb0d000d8b566f12
MD5 41a4213acd591f7530e14bb0b3c79101
BLAKE2b-256 3b1f2e37658234cb098f282192a5c276de6f9803cc2c87c0686716cc325af0ce

See more details on using hashes here.

File details

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

File metadata

  • Download URL: orbmem-1.0.6-py3-none-any.whl
  • Upload date:
  • Size: 23.6 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 397ee35e1c6da3335c04a639969d7a21715cda930085038c8c4ddb4d6942f312
MD5 3ce7dc4e2f50ee3083a4a25d1d6dd825
BLAKE2b-256 48fc3aa11bdce316c127fd6b5c330fac685ba0f540ce6679e206949d29c08867

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