Skip to main content

SANCTIS v3.51 - Cognitive Architecture for LLMs

Project description

SANCTIS v3.51

A cognitive architecture that gives LLMs structured thinking patterns — without the copy-paste.

PyPI version License: CC BY-NC-SA 4.0


What is SANCTIS?

SANCTIS is a model-facing cognitive architecture that provides LLMs with structured thinking patterns (decomposition, synthesis, arbitration, reflection, etc.) so they can reason more coherently, maintain context better, and behave more consistently over long interactions.

Think of it as giving the model a "cognitive operating system" — it doesn't make the model smarter, but it gives it better tools to think with.

Key insight: LLMs are already capable of sophisticated reasoning. SANCTIS simply gives them a reliable structure to use those capabilities more effectively.


Why SANCTIS?

Most LLM failures aren't intelligence failures — they're coherence, continuity, and behavioral stability failures.

SANCTIS helps with:

  • Long-horizon coherence
  • Reduced contradiction and drift
  • Better multi-turn conversations
  • More consistent agent behavior
  • Structured reasoning without manual prompting

Installation

pip install sanctis litellm
That's it. No more copying 390 lines of prompt.

Quick Start

Basic Usage

Python

from sanctis import run

response = run("Explain quantum computing simply")
print(response)

Multi-turn Conversations

Python

from sanctis import Conversation

conv = Conversation()
response1 = conv.run("My name is Luke.")
response2 = conv.run("What is my name?")
print(response2)  # "Your name is Luke."
With LangChain

Python

from sanctis.langchain import get_sanctis_runnable

llm = get_sanctis_runnable("ollama/llama3")
response = llm.invoke("Tell me a story about a robot learning to feel.")
print(response.content)

Command Line

Bash
sanctis run "Explain how transformers work"
sanctis setup

Key Features

Smart Defaults  Automatically detects Ollama or OpenAI
Configuration System  Set defaults once (sanctis config set model ollama/llama3)
Generation Parameters  Control temperature, max_tokens, top_p, etc.
Streaming Support  Real-time responses in CLI and Python(LangChain support coming soon)
LangChain Integration  Drop-in Runnable for agents and chains
Professional CLI  Includes interactive setup wizard
Clear Error Messages  Helpful guidance when things go wrong


How It Works (Simple Explanation)
LLMs are fundamentally text prediction engines. SANCTIS gives them a structured pattern of thinking (inspired by how humans actually reason) that they can "text predict" their way through.
Instead of hoping the model figures out good reasoning on its own, SANCTIS provides:

Decomposition modes
Synthesis modes
Arbitration & contradiction resolution
Reflection & refinement modes
Narrative & creative modes

The model activates these as needed  silently, unless you ask it to show its work.

Configuration

Bash

# Set a default model
sanctis config set model ollama/llama3

# List all settings
sanctis config list

# Get a specific setting
sanctis config get temperature

Advanced Usage
Custom Generation Parameters
Python

from sanctis import run, Conversation

# Single turn with custom settings
response = run(
    "Write a detailed technical explanation",
    temperature=0.3,
    max_tokens=2000,
    top_p=0.9
)

# Conversation with custom settings
conv = Conversation(temperature=0.8, max_tokens=500)

Streaming

Python

from sanctis import run

sfor chunk in run("Tell me a long story", stream=True):
    print(chunk.choices[0].delta.content, end="", flush=True)

Philosophy

"Compassion = Efficacy"

Clarity, coherence, and stability increase performance and reduce friction. SANCTIS is built on the belief that giving models better structure to think with leads to better outcomes than trying to force better behavior through constraints alone.

License
SANCTIS is free for research and evaluation.
Commercial deployment requires a licensing agreement.
© Luke "Umbraflamma" Yuro 2025–2026
From Sanctis, flame and shadow walk as one.

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

sanctis-3.51.1.tar.gz (13.1 kB view details)

Uploaded Source

Built Distribution

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

sanctis-3.51.1-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

Details for the file sanctis-3.51.1.tar.gz.

File metadata

  • Download URL: sanctis-3.51.1.tar.gz
  • Upload date:
  • Size: 13.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for sanctis-3.51.1.tar.gz
Algorithm Hash digest
SHA256 ad18b32e6ce4a00e2d0cc62f0eef0b062545eecfa012aacdbbd9a347585347cc
MD5 99c9881a353a5886c35c7e9a2d7f8c39
BLAKE2b-256 0d34d1a0b08edb077b739d12111aa58716623d4edd01c31b20e5d9409e3b6873

See more details on using hashes here.

File details

Details for the file sanctis-3.51.1-py3-none-any.whl.

File metadata

  • Download URL: sanctis-3.51.1-py3-none-any.whl
  • Upload date:
  • Size: 12.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.11

File hashes

Hashes for sanctis-3.51.1-py3-none-any.whl
Algorithm Hash digest
SHA256 5df479f1c9be2259245397a12104f27628031e6381cf436824719bf169d33389
MD5 eb767f859a2d92d5fc4bda4c9db6e180
BLAKE2b-256 412281957a7b22d36ef44cb718d0ee7d919c4ccc49b3485d8c8113abbc19eeea

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