Python SDK

\n\n```python\nfrom nocturnusai import SyncNocturnusAIClient\n\nwith SyncNocturnusAIClient(\"http://localhost:9300\") as client:\n ctx = client.process_turns(\n turns=[\n \"user: Customer says they are enterprise and blocked on SLA credits.\",\n \"tool: CRM says account is Acme Corp with a 2M ARR contract.\",\n ],\n scope=\"ticket-42\",\n session_id=\"ticket-42\",\n )\n\n diff = client.diff_context(session_id=\"ticket-42\", max_facts=12)\n client.clear_context_session(\"ticket-42\")\n\n print(ctx.briefing_delta)\n```\n\n

\n\n

TypeScript SDK

\n\n```ts\nimport { NocturnusAIClient } from 'nocturnusai-sdk';\n\nconst client = new NocturnusAIClient({\n baseUrl: 'http://localhost:9300',\n tenantId: 'default',\n});\n\nconst ctx = await client.processTurns({\n turns: [\n 'user: Customer says they are enterprise and blocked on SLA credits.',\n 'tool: CRM says account is Acme Corp with a 2M ARR contract.',\n ],\n scope: 'ticket-42',\n sessionId: 'ticket-42',\n});\n\nconst diff = await client.diffContext({ sessionId: 'ticket-42', maxFacts: 12 });\nawait client.clearContextSession('ticket-42');\nconsole.log(ctx.briefingDelta);\n```\n\n

\n\n

MCP

\n\n```json\n{\n \"mcpServers\": {\n \"nocturnus\": {\n \"url\": \"http://localhost:9300/mcp/sse\",\n \"transport\": \"sse\"\n }\n }\n}\n```\n\nUse the `context` tool each turn for a salience-ranked working set. Pair MCP with the HTTP context endpoints when you need goal-driven assembly and diffs.\n\n

\n\n---\n\n## What Lives Behind The Workflow\n\nWhen you do need backend mechanics, NocturnusAI provides them:\n\n- Deterministic fact and rule storage\n- Backward-chaining inference with proof chains\n- Truth maintenance and contradiction handling\n- Temporal facts with `ttl`, `validFrom`, and `validUntil`\n- Multi-tenancy via `X-Database` and `X-Tenant-ID`\n- MCP, REST, Python SDK, TypeScript SDK, and CLI surfaces over the same engine\n\n---\n\n## Quick Start\n\n### Docker (fastest)\n\n```bash\ndocker run -d --name nocturnusai -p 9300:9300 \\\n --restart unless-stopped \\\n -v nocturnusai-data:/data \\\n ghcr.io/auctalis/nocturnusai:latest\n```\n\n```bash\ncurl http://localhost:9300/health # Verify it's running\n```\n\n### Docker with Ollama (enables natural-language extraction)\n\n```bash\ndocker run -d --name nocturnusai -p 9300:9300 \\\n --add-host=host.docker.internal:host-gateway \\\n -e LLM_PROVIDER=ollama \\\n -e LLM_MODEL=granite3.3:8b \\\n -e LLM_BASE_URL=http://host.docker.internal:11434/v1 \\\n -e EXTRACTION_ENABLED=true \\\n ghcr.io/auctalis/nocturnusai:latest\n```\n\n### From this repo\n\n```bash\nmake up-ollama && make smoke\n```\n\n---\n\n## CLI\n\n```bash\nnocturnusai # Interactive REPL\nnocturnusai -e \"context 10\" # Salience-ranked working set\nnocturnusai -e \"compress\" # POST /memory/compress\nnocturnusai -e \"cleanup 0.05\" # POST /memory/cleanup\n```\n\n---\n\n## Documentation\n\nFull docs: **[nocturnus.ai](https://nocturnus.ai)**\n\n| | |\n|---|---|\n| [Start Here](https://nocturnus.ai/docs) | The turn-reduction workflow |\n| [Context Workflow](https://nocturnus.ai/docs/context) | Raw turns → optimize → diff → clear |\n| [API Reference](https://nocturnus.ai/docs/api) | REST endpoints and response shapes |\n| [SDKs](https://nocturnus.ai/docs/sdks) | Python and TypeScript client methods |\n| [Integrations](https://nocturnus.ai/integrations) | LangChain, CrewAI, AutoGen, MCP, and more |\n| [Benchmark](https://nocturnus.ai/benchmark) | Measured token reduction on live APIs |\n| [Calculations](https://nocturnus.ai/calculations) | Every number, derived |\n| [How It Works](https://nocturnus.ai/how-it-works) | The extraction → inference → delta pipeline |\n\n---\n\n## Docker Compose (advanced)\n\n```bash\ngit clone https://github.com/Auctalis/nocturnusai.git && cd nocturnusai\n\nmake up # Server using .env.example defaults\nmake up-ollama # + Ollama (reuses host or starts bundled)\nmake up-monitoring # + Prometheus + Grafana\nmake smoke # Verify health + context endpoint\n```\n\n## Build from Source\n\nRequires JDK 17+.\n\n```bash\n./gradlew :nocturnusai-server:run # HTTP server on :9300\n./gradlew :nocturnusai-cli:run # Interactive REPL (JVM)\n./gradlew :nocturnusai-cli:nativeCompile # Build native binary\n./gradlew test # Full test suite\n```\n\n---\n\n## Contributing\n\nSee [CONTRIBUTING.md](https://github.com/Auctalis/nocturnusai/blob/main/CONTRIBUTING.md). Issues labelled `good first issue` are good entry points.\n\n## Security\n\nReport vulnerabilities privately via [GitHub Security Advisories](https://github.com/Auctalis/nocturnusai/security/advisories/new). See [SECURITY.md](https://github.com/Auctalis/nocturnusai/blob/main/SECURITY.md).\n\n## License\n\n[Business Source License 1.1](https://github.com/Auctalis/nocturnusai/blob/main/LICENSE) (SPDX: `BUSL-1.1`). Free for internal use — including internal production — inside your own organization. Offering NocturnusAI or substantial functionality as a product/hosted service to third parties requires a commercial license ([licensing@nocturnus.ai](mailto:licensing@nocturnus.ai)). Converts to Apache 2.0 on 2030-02-19. See [LICENSE](https://github.com/Auctalis/nocturnusai/blob/main/LICENSE) and [DISCLAIMER.md](https://github.com/Auctalis/nocturnusai/blob/main/DISCLAIMER.md).\n\n---\n\n> **LEGAL & SAFETY NOTICE**\n>\n> NocturnusAI is a deterministic reasoning engine, but **its output is only as reliable as the facts provided to it.**\n>\n> 1. **No Warranty of Truth.** \"Verified\" refers to logical consistency of inference, not accuracy of real-world claims.\n> 2. **Not for Autonomous High-Stakes Decisions.** Do not use this engine for unsupervised medical, financial, legal, or physical-safety decisions without an independent human verification step.\n> 3. **Logic Layer Only.** NocturnusAI provides information and inference; it does not execute actions.\n> 4. **No Liability.** See [DISCLAIMER.md](https://github.com/Auctalis/nocturnusai/blob/main/DISCLAIMER.md) and [LICENSE](https://github.com/Auctalis/nocturnusai/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"categoryDisplayName","AI Agents","upstream",{"_93":94,"_95":96,"_97":98,"_99":100,"_101":102},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_91":78,"_92":78},"ratingAvg","reviewCount","topics",[103,104,29,105,106,107,108,109,110,111,112,113,114,115],"license","NOASSERTION","language","Kotlin","registryName","ai.nocturnus/logic-server","homepage","https://nocturnus.ai/","agentic-ai","agents","ai-memory","backward-chaining","context-engineering","cost-optimization","inference-engine","knowledge-graph","langchain","logic-programming","mcp","reasoning","truth-maintenance","ENV",{"_118":119,"_120":121,"_122":123},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]