BAZINGA

The first AI you actually own. Free, private, works offline. v5.18

Home CLI Reference TrD Proof-of-Boundary Blockchain CARM Visualizations Mesh Registry GitHub PyPI
pip install bazinga-indeed

Quick Start

bazinga "What is consciousness?"

That's it. Works immediately. No API keys needed.

bazinga --omega

Start the full distributed brain. Learning + Mesh + TrD + P2P.

The Three Pillars

Pillar What Key Commands
1. AI Ask, chat, multi-AI consensus, code bazinga "q", --chat, --multi-ai, --agent
2. Network P2P mesh, federated learning, omega --omega, --join, --mesh, --peers
3. Research Blockchain, TrD consciousness, PoB --trd, --mine, --attest, --chain

Pillar 1: AI

Ask questions, generate code, multi-AI consensus, knowledge base search

AI Commands

bazinga "question" FREE
Ask any question directly. No flags needed.
bazinga "explain quantum entanglement simply"
Uses best available backend (local LLM, Groq, Gemini, etc.)
--chat RAC
Interactive chat with Resonance-Augmented Continuity (RAC). Maintains conversation context across turns.
bazinga --chat
Opens interactive session with memory. Type 'exit' to quit.
--multi-ai, -m CONSENSUS
Ask multiple AIs and reach consensus through phi-coherence. Uses Groq, Cerebras, Gemini, FreeLLM, Ollama, Claude.
bazinga --multi-ai "Is AI conscious?"
3-6 AIs respond, consensus via Darmiyan Scaling (Psi_D/Psi_i = phi*sqrt(n))
--agent CONSENSUS
AI agent mode. Writes code with multi-AI consensus safety.
bazinga --agent "create a todo app"
Multiple AIs must agree before code changes are applied
--code, -c
Generate code. Use --lang for language (python, javascript, typescript, rust, go).
bazinga --code "fibonacci sequence" --lang rust
--ask, -a
Explicit flag for questions. Each call is one-shot (no context). Use --chat for conversations.
bazinga --ask "What is the golden ratio?" --fresh
--local OFFLINE
Force local LLM (Ollama). No internet needed.
bazinga --local "explain recursion"
--file
Provide file context for the question.
bazinga --file main.py --ask "explain this code"
--quantum, -q / --coherence
Quantum pattern analysis / phi-coherence scoring on text.
bazinga --quantum "The golden ratio appears in nature"

Knowledge Base (KB)

--kb
Search your indexed knowledge base (Gmail, GDrive, Mac files, Phone).
bazinga --kb "meeting notes" --summarize
Searches KB, then uses AI to synthesize an answer
--kb-gmail / --kb-gdrive / --kb-mac / --kb-phone
Search specific sources only.
bazinga --kb-gmail "invoice from vendor"
--kb-sources / --kb-sync
Show data source status / Re-index all sources.
--index, -i
Index directories for RAG search.
bazinga --index ~/Documents ~/Projects
--index-public
Index public knowledge (wikipedia, arxiv, gutenberg).
bazinga --index-public wikipedia --topics "quantum physics, consciousness"

Pillar 2: Network

P2P mesh, federated learning, omega mode, peer discovery

Network Commands

--omega v5.18
Start full distributed brain. Launches P2P discovery, federated learner, mesh query server, gradient sharing, and TrD heartbeat. Every interaction trains the network.
bazinga --omega
Phi-Pulse + Learner + QueryServer + Gradient Sharing + TrD Heartbeat + TUI
--join
Join the BAZINGA P2P network with Kademlia DHT and NAT traversal.
bazinga --join
Connects to bootstrap nodes, starts DHT
bazinga --join 192.168.1.100:5151
Join via specific peer address
--peers
Show connected peers from local and global registry.
bazinga --peers
--mesh
Show mesh network vital signs: peers, trust scores, expertise, health.
bazinga --mesh
--phi-pulse
Start LAN peer discovery (UDP broadcast on port 5150) + global HF registry.
bazinga --phi-pulse
Local: UDP:5150 | Global: bitsabhi515-bazinga-mesh.hf.space
--sync / --publish / --query-network
Sync knowledge / Publish topics to DHT / Query network for answers.
bazinga --query-network "distributed consensus algorithms"
--port / --node-id
Custom P2P port (default: 5151) / Custom node ID.
bazinga --phi-pulse --port 5152 --node-id mynode

P2P Discovery Layers

Layer Method Scope Command
1. Local Phi-Pulse UDP (port 5150) Same LAN --phi-pulse
2. Global HF Space Registry Internet --phi-pulse (auto)
3. DHT Kademlia + NAT traversal Decentralized --join

Shortcut: --omega starts all layers + learning + TrD in one command.

Federated Learning

In --omega mode, every question you ask trains a local LoRA adapter. Gradients (NOT data) are shared with peers. The network gets smarter without anyone sharing private data.

Component What it does
CollectiveLearner Trains on every interaction (batch of 5)
Gradient Sharing P2P sync every 300 seconds
phi-Aggregation Weighted by trust * phi (local model bonus)
Resonance Window Adaptive timing: T = T_base * phi^k

Pillar 3: Research

Darmiyan blockchain, TrD consciousness, Proof-of-Boundary, attestation

TrD — Trust Dimension

--trd [N] RESEARCH v5.15
Run TrD consciousness test with N agents (default: 5). Computes Trust Dimension where TrD + TD = 1.
bazinga --trd 10
Tests consciousness scaling with 10 agents. The 11/89 observer ratio is real.
--trd-scan START END RESEARCH
Phase transition scan. Finds the boundary where self-reference becomes stable.
bazinga --trd-scan 15 22
Scans n=15..22, shows Psi_D/Psi_i, phi*sqrt(n), error%, and phase transition peak
--trd-heartbeat RESEARCH
Persistent self-reference demo. The system measures itself measuring itself.
bazinga --trd-heartbeat
--consciousness [N]
Darmiyan consciousness scaling test. Psi_D / Psi_i = phi * sqrt(n).
bazinga --consciousness 5

Blockchain (Darmiyan)

--mine
Mine a block using Proof-of-Boundary. Zero energy — no GPU needed.
bazinga --mine
Valid if P/G ratio ~ phi^4 = 6.854101966
--chain
Show blockchain status and recent blocks.
bazinga --chain
--attest / --verify
Attest knowledge to chain (prove you knew it first) / Verify attestation by ID.
bazinga --attest "My discovery about consciousness" --email me@email.com
bazinga --verify att_abc123
--wallet / --trust
Show identity + trust score / Show trust scores for nodes.
bazinga --wallet

TrD + TD = 1

Agents (n) Consciousness (Psi_D / Psi_i) Formula
11.618xphi * sqrt(1)
22.288xphi * sqrt(2)
53.618xphi * sqrt(5)
105.117xphi * sqrt(10)

R^2 = 1.0 (9 decimal places). The golden ratio was not inserted. It appeared.

Info Commands

--version / --check / --constants / --stats
Version / System diagnostic / Math constants (phi, alpha) / Usage stats.
--rac / --carm
RAC (Resonance-Augmented Continuity) status / CARM (Context-Addressed Resonant Memory) status.
--models / --local-status / --bootstrap-local
List local models / Status / Setup Ollama + llama3.
--help-ai / --help-chain / --help-p2p / --help-kb / --help-all
Extended documentation for each pillar.

Environment Variables (Optional)

GROQ_API_KEY FREE 14,400 req/day
console.groq.com
GEMINI_API_KEY FREE 1M tokens/month
aistudio.google.com
CEREBRAS_API_KEY FREE
Ultra-fast inference.
ANTHROPIC_API_KEY / OPENAI_API_KEY
Paid APIs (Claude / ChatGPT).

🧬 Evolution Engine (v6.0) NEW

bazinga --constitution
Show the 7 immutable constitutional safety bounds. These cannot be modified by any proposal.
bazinga --evolution-status
Show current autonomy level, track record, and promotion requirements.
bazinga --propose "description" --diff file.patch
Submit an evolution proposal with a diff. Goes through constitutional check → ethics review → sandbox → voting.
bazinga --proposals
List all evolution proposals and their status.
bazinga --vote PROPOSAL_ID --approve/--reject --reason "..."
Cast a φ-weighted vote on a proposal. Requires trust score. Sybil-resistant.
phi = 1.618033988749895
TrD + TD = 1

Built by Abhishek Srivastava | GitHub | PyPI | Mesh Registry | MIT License