Skip to content

Cognio v0.1.0 - Initial Release

Latest
Latest

Choose a tag to compare

View all tags
@0xReLogic 0xReLogic released this 05 Oct 18:50
v0.1.0
ecb5764

Cognio v0.1.0

MCP Server for Persistent Semantic Memory

What's New

This is the initial stable release of Cognio, a production-ready Model Context Protocol (MCP) server that provides long-term semantic memory capabilities for AI applications.

Core Features

Memory Operations

  • Semantic Search: Powered by sentence-transformers (all-MiniLM-L6-v2 model)
  • Full CRUD: Save, search, list, delete, and bulk-delete operations
  • Duplicate Detection: Automatic deduplication using SHA256 hashing
  • Date Range Filtering: Filter memories by creation time
  • Relevance Sorting: Sort results by semantic relevance to query

Organization & Export

  • Project Management: Organize memories by project
  • Tag System: Flexible tagging for categorization
  • Statistics: Aggregate counts by project and tags
  • Export Formats: JSON and Markdown export support

Security & Performance

  • Optional API Key Auth: Protect endpoints with X-API-Key header
  • CORS Support: Cross-origin request handling
  • Persistent Storage: SQLite database with embedding support
  • Fast Search: ~15ms average search time

Developer Experience

  • Docker Support: Production-ready Dockerfile and docker-compose
  • CI/CD Pipeline: GitHub Actions with linting, testing, Docker build
  • Test Coverage: 100% passing tests (API, embeddings, memory, utils)
  • Migration System: Database versioning and schema migrations
  • Comprehensive Docs: README, CONTRIBUTING, QUICKSTART guides

API Endpoints

  • POST /memory - Save memory
  • POST /memory/search - Semantic search
  • GET /memory/list - List with filters/sorting
  • DELETE /memory/{id} - Delete single memory
  • POST /memory/bulk-delete - Bulk delete by project
  • GET /memory/stats - Statistics
  • GET /memory/export - Export data

Quick Start

# Clone repository
git clone https://github.com/0xReLogic/Cognio.git
cd Cognio

# Using Docker
docker-compose up -d

# Or manual setup
pip install -r requirements.txt
python src/main.py

Server runs on http://localhost:8080

Documentation

Tech Stack

  • Python 3.12
  • FastAPI 0.118.0
  • sentence-transformers 2.7.0
  • SQLite with JSON support
  • Docker & docker-compose

What's Next

See project roadmap for planned features.

Full Changelog: https://github.com/0xReLogic/Cognio/commits/v0.1.0

Assets 2
Loading