noscium 0.0.1__tar.gz

noscium-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ragesh
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

noscium-0.0.1/PKG-INFO

@@ -0,0 +1,85 @@
+Metadata-Version: 2.5
+Name: noscium
+Version: 0.0.1
+Summary: Institutional memory for enterprise AI assistants — governed, multi-user, organizational memory framework.
+Project-URL: Homepage, https://github.com/YOUR_GITHUB_USERNAME/noscium
+Project-URL: Repository, https://github.com/YOUR_GITHUB_USERNAME/noscium
+Project-URL: Issues, https://github.com/YOUR_GITHUB_USERNAME/noscium/issues
+Author: Ragesh
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,enterprise-ai,institutional-memory,llm,memory,organizational-memory,rag
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Noscium
+
+Institutional memory for enterprise AI assistants.
+
+Unlike retrieval systems (RAG) or single-user memory libraries, Noscium is
+designed for organizations: multiple users, teams, roles, and the governance
+that comes with it.
+
+> **Status: pre-alpha.** This repo currently holds the initial scaffold and
+> roadmap. Follow along via the [Institutional Intelligence newsletter](#)
+> for build updates.
+
+## Why Noscium
+
+Most AI agent memory systems (Mem0, Zep, and others) optimize for *individual
+recall* — one user's memories, retrieved well over time. Noscium's focus is
+different: *organizational* memory — many users, teams, and roles, and the
+access control, consolidation, and conflict resolution that come with that.
+
+## Planned Features
+
+- **Multi-user access control** — memories scoped by role and team
+- **Organizational consolidation** — individual facts become org-level knowledge
+- **Conflict resolution** — when memories contradict, track and resolve
+- **Compliance & retention** — configurable policies, audit trails, provenance
+- **Importance judging** — LLM + user feedback decides what's worth remembering
+- **Memory types** — episodic (what happened), semantic (what is true), procedural (how to do X)
+
+## Roadmap
+
+| Phase | Focus | Status |
+|---|---|---|
+| Phase 1 | Core memory model, extraction, scoped retrieval | In progress |
+| Phase 2 | Organizational consolidation, conflict resolution, memory graph | Planned |
+| Phase 3 | Governance, compliance, retention policies, full audit trail | Planned |
+
+## Installation
+
+```bash
+pip install noscium
+```
+
+(Pre-alpha — API will change without notice until a 0.1.0 release.)
+
+## Quickstart
+
+```python
+from noscium import Memory, MemoryType, VisibilityScope
+
+m = Memory(
+    id="mem_001",
+    fact="Customer X prefers async standups",
+    type=MemoryType.SEMANTIC,
+    team_id="support-team",
+    visibility_scope=VisibilityScope.TEAM,
+)
+```
+
+## License
+
+MIT

noscium-0.0.1/README.md

@@ -0,0 +1,61 @@
+# Noscium
+
+Institutional memory for enterprise AI assistants.
+
+Unlike retrieval systems (RAG) or single-user memory libraries, Noscium is
+designed for organizations: multiple users, teams, roles, and the governance
+that comes with it.
+
+> **Status: pre-alpha.** This repo currently holds the initial scaffold and
+> roadmap. Follow along via the [Institutional Intelligence newsletter](#)
+> for build updates.
+
+## Why Noscium
+
+Most AI agent memory systems (Mem0, Zep, and others) optimize for *individual
+recall* — one user's memories, retrieved well over time. Noscium's focus is
+different: *organizational* memory — many users, teams, and roles, and the
+access control, consolidation, and conflict resolution that come with that.
+
+## Planned Features
+
+- **Multi-user access control** — memories scoped by role and team
+- **Organizational consolidation** — individual facts become org-level knowledge
+- **Conflict resolution** — when memories contradict, track and resolve
+- **Compliance & retention** — configurable policies, audit trails, provenance
+- **Importance judging** — LLM + user feedback decides what's worth remembering
+- **Memory types** — episodic (what happened), semantic (what is true), procedural (how to do X)
+
+## Roadmap
+
+| Phase | Focus | Status |
+|---|---|---|
+| Phase 1 | Core memory model, extraction, scoped retrieval | In progress |
+| Phase 2 | Organizational consolidation, conflict resolution, memory graph | Planned |
+| Phase 3 | Governance, compliance, retention policies, full audit trail | Planned |
+
+## Installation
+
+```bash
+pip install noscium
+```
+
+(Pre-alpha — API will change without notice until a 0.1.0 release.)
+
+## Quickstart
+
+```python
+from noscium import Memory, MemoryType, VisibilityScope
+
+m = Memory(
+    id="mem_001",
+    fact="Customer X prefers async standups",
+    type=MemoryType.SEMANTIC,
+    team_id="support-team",
+    visibility_scope=VisibilityScope.TEAM,
+)
+```
+
+## License
+
+MIT

noscium-0.0.1/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "noscium"
+version = "0.0.1"
+description = "Institutional memory for enterprise AI assistants — governed, multi-user, organizational memory framework."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.9"
+authors = [
+    { name = "Ragesh" }
+]
+keywords = [
+    "ai",
+    "memory",
+    "agents",
+    "llm",
+    "enterprise-ai",
+    "institutional-memory",
+    "organizational-memory",
+    "rag",
+]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[project.urls]
+Homepage = "https://github.com/YOUR_GITHUB_USERNAME/noscium"
+Repository = "https://github.com/YOUR_GITHUB_USERNAME/noscium"
+Issues = "https://github.com/YOUR_GITHUB_USERNAME/noscium/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/noscium"]

noscium-0.0.1/src/noscium/__init__.py

@@ -0,0 +1,62 @@
+"""
+Noscium — Institutional memory for enterprise AI assistants.
+
+Unlike retrieval systems (RAG) or single-user memory libraries, Noscium is
+designed for organizations: multiple users, teams, roles, and the governance
+that comes with it.
+
+This is an early pre-alpha scaffold. See the project README and roadmap for
+the phased build plan (Phase 1: core memory + extraction + scoped retrieval;
+Phase 2: consolidation + conflict resolution; Phase 3: governance + compliance).
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime
+from enum import Enum
+from typing import Optional
+
+
+__version__ = "0.0.1"
+
+
+class MemoryType(str, Enum):
+    """What kind of knowledge a memory represents."""
+    EPISODIC = "episodic"    # what happened
+    SEMANTIC = "semantic"    # what is true
+    PROCEDURAL = "procedural"  # how to do something
+
+
+class VisibilityScope(str, Enum):
+    """Who in the organization can see a memory."""
+    PERSONAL = "personal"
+    TEAM = "team"
+    ORG = "org"
+
+
+@dataclass
+class Memory:
+    """
+    Core memory record.
+
+    This is a Phase 1 scaffold: the shape of the data model, not yet a
+    working extraction/retrieval/consolidation pipeline. See the roadmap.
+    """
+    id: str
+    fact: str
+    type: MemoryType
+
+    user_id: Optional[str] = None
+    agent_id: Optional[str] = None
+    created_at: datetime = field(default_factory=datetime.utcnow)
+
+    team_id: Optional[str] = None
+    department_id: Optional[str] = None
+    visibility_scope: VisibilityScope = VisibilityScope.PERSONAL
+
+    importance_score: float = 0.0
+    invalidated: bool = False
+
+
+__all__ = ["Memory", "MemoryType", "VisibilityScope", "__version__"]