How aminshahsaheb/fanus-living-seal works
Fānus is an epistemic AI runtime: its main interaction loop records user input, searches a knowledge gateway, generates a response, stores that response, and applies cognitive and guardian checks before returning it. The repository also documents a memory pipeline, research and growth capabilities, runtime safety and evolution, and a separate verification/audit capability. Edges are limited to relationships visible in the excerpts or SOURCE INDEX; documented but unsampled subsystems are shown without guessed call paths.
Main entry points: main.py Fanus System · pipeline.py Memory Pipeline · audit_engine.py Audit Engine · guardian_pipeline.py Guardian Pipeline
Components 25
Interaction Runtime
- Fanus System
fanus/main.py - Runtime Loop
fanus/runtime/loop.py - Groq Adapter
fanus/adapters/groq_adapter.py - System Identity
fanus/core/identity.py
Knowledge and Memory
- Knowledge Gateway
fanus/adapters/knowledge_gateway.py - Memory Pipeline
fanus/memory/pipeline.py - Evidence Engine
fanus/memory/evidence_engine.py - Belief Layer
fanus/memory/belief_layer.py - Memory Ledger
fanus/memory/ledger.py - Knowledge Graph
fanus/memory/knowledge_graph.py - Memory Persistence
fanus/memory/persistence.py
Cognitive Governance
- Cognitive Orchestrator
fanus/cognitive/orchestrator.py - Guardian Pipeline
fanus/cognitive/guardian_pipeline.py - Policy Engine
fanus/cognitive/policy_engine.py - Hayrat Judge
fanus/cognitive/hayrat_judge.py - Flattery Detection
fanus/cognitive/fi_detector.py - Negar Detection
fanus/cognitive/negar_detector.py - Identity Safeguards
fanus/cognitive/isp_controller.py - Cognitive Growth
fanus/cognitive
Runtime Evolution
- Runtime Safety
fanus/runtime/safety - Runtime Observer
fanus/runtime/observer/runtime_observer.py - Evolution Engine
fanus/evolution/evolution_engine.py
Verification
- Audit Engine
fanus/audit/audit_engine.py - Verify API
fanus/api/server.py
Other components
- User
Connections 25
- User → Fanus System: submits input
fanus/main.py - Fanus System → Memory Pipeline: stores input and response
fanus/main.py - Fanus System → Knowledge Gateway: searches knowledge
fanus/main.py - Fanus System → Runtime Loop: ticks runtime
fanus/main.py - Fanus System → System Identity: loads identity prompt
fanus/main.py - Fanus System → Groq Adapter: generates response
fanus/main.py - Fanus System → Cognitive Orchestrator: processes exchange
fanus/main.py - Fanus System → Guardian Pipeline: checks response
fanus/main.py - Fanus System → Policy Engine: evaluates signals
fanus/main.py - Fanus System → Identity Safeguards: checks identity risk
fanus/main.py - Fanus System → Hayrat Judge: revises response
fanus/main.py - Memory Pipeline → Evidence Engine: evaluates evidence
fanus/memory/pipeline.py - Memory Pipeline → Belief Layer: records belief
fanus/memory/pipeline.py - Memory Pipeline → Memory Ledger: records entry
fanus/memory/pipeline.py - Memory Pipeline → Knowledge Graph: adds entity
fanus/memory/pipeline.py - Memory Pipeline → Memory Persistence: restores and saves
fanus/memory/pipeline.py - Guardian Pipeline → Flattery Detection: runs detection
fanus/cognitive/guardian_pipeline.py - Guardian Pipeline → Negar Detection: runs detection
fanus/cognitive/guardian_pipeline.py - Guardian Pipeline → Hayrat Judge: runs judgment
fanus/cognitive/guardian_pipeline.py - Audit Engine → Evidence Engine: evaluates claims
fanus/audit/audit_engine.py - Audit Engine → Belief Layer: updates beliefs
fanus/audit/audit_engine.py - Audit Engine → Hayrat Judge: judges uncertainty
fanus/audit/audit_engine.py - Audit Engine → Policy Engine: evaluates signals
fanus/audit/audit_engine.py - Verify API → Audit Engine: offers verification
- Knowledge Gateway → User: retrieves sources