FAQ & Documentation

Plain-language answers and technical reference for the ZeroThink Sovereign Architecture. Multi-provider routing, Oracle analysis, Pro-only Quantum lane, $AI holder access, no-token local library context, large code ingest, and the cross-platform CLI stack.

Default route clarity: ZeroThink still defaults to Groq GPT-OSS 120B for the website and the main Zero lane. OpenAI GPT-5.5 and the GPT-5.4 family are additional Pro options when you explicitly switch to the OpenAI provider. OpenZero Local is a Pro lane for small self-hosted models under 15 GB: when the shared ZeroThink OpenZero gateway is enabled, Pro accounts can try it for 5 messages, then should install OpenZero and save their own OpenZero Machine API Key in Neural Vault through a server-side registered gateway. Featherless is the hosted large-model lane and requires the user's own Featherless key. Quantum remains its own Pro lane built on Groq GPT-OSS 120B + IonQ Quantum Cloud, with a separate IBM Qiskit lane for Qiskit calculation packets and optional IBM Quantum Runtime context.

Latest public update: ZeroThink documentation now highlights the OpenZero bridge, limited shared OpenZero trial behavior, user-owned OpenZero Machine API Keys, Z-Spark-aware OpenZero nodes, optional Voicebox direction, AI PDF Creator guidance, and the public-safe TalkToAI updates/changelog page. Read the ecosystem changelog at docs.talktoai.org/updates/.

All documentation sections are visible.

Latest Public Updates

OpenZero Bridge

ZeroThink can use OpenZero as a local/self-hosted AI lane where the bridge is configured. Shared gateway access should stay limited; continued use belongs on a user-owned OpenZero node key saved in Neural Vault.

Z-Spark Awareness

OpenZero nodes may support Z-Spark, a custom draft/verify route where a small local model drafts and the active model verifies or rewrites. It falls back safely when a node is not ready.

Voicebox Direction

OpenZero can connect to Voicebox when a user installs that local voice service separately. Voice features remain optional and should be enabled only on machines prepared for voice workflows.

PDF Creator

PDF requests work best when the user states audience, sections, evidence needs, caveats, and export purpose. Serious reports should be reviewed before sharing.

Access Tiers

Free Tier

High-speed access to open-weights models. Ideal for coding and rapid inquiry.

  • Groq Cloud: GPT-OSS 120B/20B, Compound, Qwen 3.6, Llama 3.1 8B, ALLaM 2
  • NVIDIA NIM: Qwen 3 Coder 480B, Gemma 4 31B, DeepSeek V3.2, Codestral, Devstral
  • CLI: Linked-account login or no-Google direct mode, folder-only or machine-wide access, SSH profiles, remote file workspace tools, Playwright MCP, named agents, autopilot runs, local plan board, verified self-update, local or Vault-backed provider keys, and local Z-Pepper password protection for files or folders
  • Quantum Lane: Pro only
  • ZeroThink Logic: Disabled
Sovereign Pro

Full access to ZeroThink Logic, Pro routing, Quantum Zero, and proprietary closed-source model lanes.

  • ZeroThink Logic: Active (Reasoning Layer)
  • xAI: Grok 4.3, Grok Build 0.1, Grok Imagine API
  • OpenAI: GPT-5.5, GPT-5.4, GPT-5.4 Mini, GPT-5.4 Nano, GPT-5 family fallbacks
  • Google: Gemini 3.5 Flash, Gemini 3.1 Pro, Gemini 3.1 Flash-Lite, Gemini 2.5 fallbacks
  • OpenZero: when the shared gateway is enabled, 5 shared local messages on ZeroThink, then bring your own registered OpenZero node key for continued local/self-hosted use
  • Featherless: hosted large-model lane for TalkToAI ZERO, GLM 5.2, GLM 4.5, Qwen3 Coder, DeepSeek, and Kimi using the user's own Featherless key
  • Quantum: Groq GPT-OSS 120B with IonQ Quantum Cloud telemetry and optional simulator job proof
  • Billing: Pay with PayPal or verify a Solana wallet holding at least $10 worth of $AI. Token-holder access uses a signed wallet message, never asks for a seed phrase, and is automatically rechecked. If holdings are sold below the threshold, token-holder Pro access is removed. Monthly payments are non-refundable. Yearly refund requests are within 7 days via shaf@talktoai.org

$AI Utility

The practical use case is simple: $AI is a hold-to-access utility path for ZeroThink Pro. Users can still pay with PayPal, but token holders can verify a Solana wallet and unlock Pro while they maintain enough verified holdings.

Access Utility

Hold at least $10 worth of $AI in a verified Solana wallet to activate ZeroThink Pro access. This unlocks the same Pro surface: ZeroThink Logic, Pro model lanes, Quantum Zero, Oracle improvements, and the wider builder stack.

Proof Without Custody

Verification uses a one-time wallet signature. ZeroThink never asks for seed phrases, never moves tokens, and never requires a payment transaction for token-holder access. The wallet only signs a message proving ownership.

Sell = Lose Access

Token-holder Pro is monitored. The server rechecks live holdings and live market value. If the wallet sells below the threshold, token-holder Pro access is automatically removed on the next scheduled check. PayPal Pro accounts are not affected by this token check.

Degen Answer

Use case: the coin is an access key for an AI product, not just a meme. Holding enough $AI unlocks a real software benefit, and selling below the floor removes that benefit. That creates a direct utility loop between the token and ZeroThink Pro.

Token Mint

$AI Token CA: dHdkhZsmBQhXjQoKbkyajZ3Ff4W2XumGyVJX4jypump

Verify holder access on the Upgrade page.

Track AI/SOL on GeckoTerminal.

No Investment Promise

$AI holder access is a product utility feature. It is not financial advice, not a promise of profit, and not a guarantee of token price. Access depends on live wallet balance, market data, and the current ZeroThink eligibility rules.

The Model Matrix

ProviderModel NameSpecsAccessBest Use
GROQGPT-OSS 120B / GPT-OSS 20B / CompoundCurrent fast cloud stackFreeGeneral reasoning, Oracle, broad strategic work
GROQQwen 3.6 27B / Llama 3.1 8B Instant / ALLaM 2 7BCurrent Groq open-weight and specialist laneFreeCoding, structured analysis, fast iterations, bilingual Arabic-English work
GROQLegacy IDs: Llama 3.3 70B, Llama 4 Scout/Maverick, Qwen3 32B, Kimi K2Hidden from pickers and routed to GPT-OSS 120B when old selections appearFreeMigration safety only; use GPT-OSS 120B or Qwen 3.6 for new work
NVIDIAQwen 3 Coder 480B / Codestral 22B / Devstral 2Heavy coding + instructFreeLarge code work, technical drafting, deep analysis
NVIDIAGemma 4 31B / Gemma 3n E4B / DeepSeek V3.2 / Llama 3.3 70BCurrent NVIDIA frontier setFreeLong-form reasoning, multilingual work, coding and research
xAIGrok 4.3 / Grok Build 0.1 / Grok Imagine APICurrent premium xAI lineProReasoning, coding, live premium use
GOOGLEGemini 3.5 Flash / Gemini 3.1 Pro / Gemini 3.1 Flash-Lite / Gemini 2.5Multimodal + long-contextProLarge documents, deeper analysis, mixed text/media work
OPENAIGPT-5.5 / GPT-5.4 / GPT-5.4 Mini / GPT-5.4 NanoCurrent frontier + lower-cost variantsProOptional premium lane when you switch away from the default Groq route
OPENZEROGLM 4 9B Q5 / Hermes 3 8B Q5 / Gemma 4 E4BLocal/self-hosted aliases capped below 15 GB; current GLM 4 Q5 GGUF is about 6.6 GBProPrivate local CPU tasks, small automation, dev/research drafts; 5 shared messages when enabled, then BYO registered OpenZero key
FEATHERLESSTalkToAI ZERO / GLM 5.2 / GLM 4.5 / Qwen3 Coder / DeepSeek / KimiHosted OpenAI-compatible model lane; large models run on Featherless, not the local ZeroThink serverProHosted large-model experiments with the user's own Featherless account/key
QUANTUMGroq GPT-OSS 120B + IonQ CloudSpecial research agent with backend telemetry and simulator job recordsProQuantum-assisted planning, hardware-aware research, backend-aware synthesis
QISKITGroq GPT-OSS 120B + IBM QiskitQiskit calculation packets with optional IBM Runtime/backend contextProBell/GHZ, Grover, QAOA, VQE, QFT, and prompt-seeded Zero pattern experiments

Oracle Desk

Crypto + General

The Oracle route is tuned for both crypto scenarios and broader strategic calls. Modes include crypto, general, launch, and risk.

Default Engine

Oracle now defaults to Groq + GPT-OSS 120B for a strong speed / reasoning balance, while still letting you switch provider and model directly from the desk. Current Groq alternatives include Compound, GPT-OSS 20B, Qwen 3.6, Llama 3.1 8B, and ALLaM 2; older Groq IDs are kept only as migration aliases.

Support The Project

The Oracle page includes a Solana support card so people who use the desk heavily can donate directly to the ZeroThink build.

Direct Web Mode

If someone wants ZeroThink without Google login first, the lean browser route is exposed at /guest. That lane accepts local Groq or NVIDIA keys, keeps memory/history off, does not connect to the ZeroThink account/Vault, and stores the key only in the browser.

Quantum Lane

Special Agent

Quantum is a special Pro agent inside Studio. It does not replace the normal default route. Instead, it switches into a separate research lane that reasons through Groq GPT-OSS 120B and then grounds that reasoning with IonQ Quantum Cloud account data, backend telemetry, and small simulator job records when enabled, so the answer reflects real quantum infrastructure instead of vague sci-fi language.

What “Real Quantum AI” Means

ZeroThink Pro is not claiming that the LLM itself runs on quantum hardware. It is hybrid quantum-informed AI: a classical model does the language reasoning, while real quantum-cloud telemetry, backend/account context, and optional IonQ simulator job records are brought into the prompt/context layer. Real integration, not fake magic.

Deliberate Research Posture

The lane is designed as a research surface, not a fake “magic quantum oracle.” ZeroThink uses IonQ key validation, backend availability, queue posture, characterization context, and job IDs/results when a simulator proof is created, while Groq remains the fast reasoning core. In short: classical AI engine, quantum-informed research mode.

Low API Usage Mode

Quantum Zero and Studio Quantum are tuned to stay friendly to free or low-volume IonQ accounts. Packet building is local/offline, backend telemetry is cached for 30 minutes, job checks are cached for 60 seconds, Studio chat reuses recent simulator proof jobs by default, and hardware QPU submissions require a deliberate checkbox.

Keys Required

IonQ Quantum needs two keys: a Groq key for GPT-OSS 120B and an IonQ key for the quantum cloud lane. IBM Qiskit needs your Groq key for the answer and an optional IBM Quantum token when you want IBM Runtime/backend context. Save keys in the Neural Vault, then switch the provider pill to QUANTUM or QISKIT.

Pro Only

Quantum access is reserved for Pro. Free accounts stay on the fast open-weights lanes and do not unlock the IonQ-backed agent.

Quantum Zero Lab

The dedicated Quantum Zero page is the simple chat surface. It now includes a larger real experiment deck for Pro users: Bell Pair Correlation, GHZ Shared-State Pulse, Entropy Beacon, Parity Pattern, Delta Branch Ethics, Omega Phi Xi Balance, ADEV Decision Spread, Harmonic Base Matrix, Six Layer Decision Pattern, and prompt-seeded QuantumZero packets. These submit/reuse small IonQ simulator jobs, read the probability histogram, then explain dominant state, top states, entropy/spread, backend evidence, and a practical result interpretation inside ZeroThink so users do not need to leave the platform. The advanced Quantum Lab restores the deeper operator console: packet inspection, IonQ status checks, proof jobs, job-result review, telemetry forensics, and research-safe mission templates. IonQ simulator submission creates a real quantum-cloud job record when requested; it does not claim magical broadcasting or qubits running the chatbot.

Six-Job Evidence Chain

Quantum Zero includes a provider-backed simulator research chain seeded from private Zero themes without exposing private equations, raw signals, run identifiers, or internal ratios. The public lane describes what the chain is for: controlled quantum-cloud experiments, entropy checks, balance checks, decision-spread checks, harmonic packets, and reproducible research notes. It is evidence for the research workflow, not proof of remote activation.

IBM Qiskit Lane

The Qiskit lane is separate from IonQ. It builds a calculation packet first, then lets Groq reason over that packet. Supported starter algorithms are Bell correlation, GHZ shared state, Grover search, QAOA MaxCut, a small VQE-style ansatz, QFT phase spread, and prompt-seeded Zero pattern circuits. Local Qiskit simulation can run without an IBM token; IBM Runtime/backend context requires the user's own IBM Quantum token and optional instance/CRN. Hardware job submission should remain deliberate and clearly labelled.

ZeroThink CLI

Cross-Platform + Guided

The ZeroThink CLI, aka Agent Zero, installs on Windows PowerShell, macOS, and Linux. It can pair to the same ZeroThink account as the web app or run in a no-Google direct mode with a local Groq or NVIDIA key. Its operator surface includes guided setup, scoped file access, local and remote workspaces, SSH/SFTP, checkpoints, planning, browser research, Playwright/MCP, encrypted file bundles, PDF report creation, saved-server health checks, site starters, playable browser game starters, named agents, and evidence-first research creation. New research commands can inspect approved files on the local computer or a saved server profile, then create a paper, article, survey, review, or proposal with a source ledger, claim matrix, verification flags, and Markdown export. The terminal remains concise; the richer public ZeroThink Reasoning Brief is shown in Studio.

Large Code Friendly

The CLI supports direct file injection, workspace scans, file search, file writes and replacements, zip creation and extraction, Z-Pepper file/folder encryption and decryption, automatic encrypted project bundles, lock/protect/unlock aliases, remote SCP transfers, remote file inspection and edits on saved server profiles, repo-level guidance files like ZEROTHINK.md, CLAUDE.md, AGENTS.md, and .claude/CLAUDE.md, local web search, saved browser pages, Playwright MCP automation for dynamic pages, page attach flows, and the same packed file strategy used in the web app, so large source files and config dumps are easier to analyze without immediately blowing the window. The CLI reasoning layer now follows a stronger private orient → inspect → plan → act → verify → report workflow instead of staying in generic assistant mode.

Operator Modes

The public install and manual page is exposed at /cli. The CLI can run in a safer folder-only mode for one repo or switch to machine mode when you want shell and server operator access, and the guide now walks beginners through install, linked-account mode, no-Google direct mode, first prompt, help topics, model selection, autocomplete, local checkpoint/resume flows, local planning, and the limits of direct mode. It also has a built-in zerothink update command that verifies the published CLI hash before replacing the local script, zerothink status for a quick local readiness snapshot, a remote workspace lane via zerothink remote ..., saved-profile checks like zerothink server check prod /var/www/html, local PDF reports like zerothink pdf create report.pdf --file notes.md, a local MCP layer with a built-in Playwright browser profile via zerothink mcp add-playwright and zerothink playwright open https://example.com, plus self-driven agent workflows like zerothink autopilot "audit this repo", zerothink agent create zero1 "map the auth flow", zerothink agent log zero1, zerothink stop zero1, and in-prompt /stop. For coding, the current recommended defaults are openai/gpt-oss-120b on Groq and qwen/qwen3-coder-480b-a35b-instruct on NVIDIA, and the fastest way to inspect the curated shortlist is zerothink models coding. If you just type a normal task like make a small game or make a new project folder for shafaet.com inside the interactive prompt, Agent Zero now routes that into execution mode automatically instead of staying in pure chat mode, unless you switch to a staging lane like /steer plan. The file/tree tools now keep broad inspections compact by skipping common dependency, cache, vendor, and backup directories unless you explicitly inspect those paths.

No-Google CLI Mode

If you skip Google login in the CLI, ZeroThink can still auto-detect GROQ_API_KEY or NVIDIA_API_KEY from your local shell, or you can store them locally with zerothink key set groq / zerothink key set nvidia. That lane does not import Vault keys, memory, saved history, linked-account session state, or Pro account state. Local CLI browser tools like zerothink search, zerothink browse, /search-web, /page, and local Playwright MCP browser commands still work because they are machine-local terminal helpers rather than website account features. For Groq and NVIDIA, the CLI can also fall back to that local direct-key lane automatically if the linked provider lane fails. If you ever want the exact live route instead of asking the model to guess, use zerothink runtime or /runtime. If you already have the CLI installed, the safe update command is simply zerothink update.

Research Paper Creator + CLI Workbench

ZeroThink separates research discovery, evidence checking, drafting, and review. The browser creator is the guided visual workflow; the CLI is the local and server-aware workflow for researchers who already have folders of notes, papers, transcripts, datasets, reports, or project files.

Browser Workflow

Research Paper Creator provides separate stages for search protocol, evidence plan, source ledger, outline, draft, reviewer critique, and revision. It supports paper type, method, audience, citation style, date range, source policy, inclusion/exclusion criteria, uploaded research files, known sources, integrity checks, and project export.

Optional uploads such as TXT, Markdown, CSV, JSON, HTML, RTF, DOCX, legacy DOC, BibTeX, notes, abstracts, draft articles, and supervisor comments are read in the browser and attached only to the current generation request. They are not saved as a public research library upload.

Built-in PDF Creator

In Studio, prompts like create a PDF report about this trigger ZeroThink's AI PDF artifact mode: the selected model drafts a polished document, optional WEB mode or explicit research wording can add Serper search context, and the answer returns a private download button. PDF Creator remains the manual editor/exporter for pasted notes, reports, drafts, source summaries, or Paper Creator output. Uploaded text files are read in the browser and sent only as document text when the user creates the PDF; the endpoint does not accept server file paths or browser-supplied URLs.

Local Files

The CLI can inspect only the files or folders the user explicitly supplies. Text, code, CSV, Markdown, DOCX, and optional PDF extraction are supported. Common credential files, private keys, dependency folders, and oversized files are excluded or inventoried by default.

zerothink research paper "AI research agents" --source ./papers --source ./notes.md --stage outline
Saved Server Evidence

In machine mode, a saved SSH profile can supply remote research files without publishing the server address in documentation. The CLI reads through SFTP, applies the same exclusions, creates a visible inventory, and removes its temporary evidence pack after the model call.

zerothink research review "Reliability evidence" --server research --remote-path /srv/research/reports
Research Stages

Choose protocol, evidence, outline, draft, critique, revision, or full. Use --dry-run to review scope without a model call, --library for compact private Zero Library retrieval, and --web only when live discovery is needed.

Citation Discipline

ZeroThink must not invent author names, papers, quotations, DOIs, URLs, page numbers, statistics, or results. Search snippets are discovery leads, not proof of full-text access. Unverified claims remain visibly marked, and the final export includes the supplied source inventory.

Source Ledger Labels

The source ledger separates Uploaded Source, User Note, Retrieved Search Result, Full Text Supplied, Model Candidate Lead, and Needs Verification. Candidate leads are not citations. They are search targets until a DOI, URL, database result, or supplied file verifies them.

Start Here
zerothink help research zerothink research scan --source ./papers zerothink research survey "Topic" --source ./evidence --citation-style "APA 7" zerothink research proposal "Topic" --source ./notes --output proposal.md

FreeWebPanel CLI Operations

Can ZeroThink CLI manage a FreeWebPanel server?

Yes. zerothink freewebpanel, with the shorter alias zerothink fwp, can install, manage, inspect, back up, diagnose, repair, update, and help operate a FreeWebPanel server. Start with status, check, or health, then use backup-first plans for repair, update, and deploy. It includes web-server, PHP, database, mail, DNS, SSL, permission, firewall, redacted-log, and existing-panel takeover/migration checks without publishing private infrastructure examples.

Is ZeroThink CLI only for installing FreeWebPanel?

No. Installation is one feature. ZeroThink CLI is the wider local server-management and hosting-operations layer for FreeWebPanel and related TalkToAI/ZeroThink work. It supports health, config, domain, log, permission, Apache/PHP, SSL, backup, repair, update, and deployment workflows after installation.

Can it change a live server by accident?

Inspection commands are read-only. Install, repair, update, deploy, and backup commands show their plan first. Use --dry-run for an explicit preview. A change requires --yes, and repair, update, or deploy should normally include --backup-first.

Does it expose passwords or API keys?

Common password, secret, token, private-key, database, SMTP, and API-key values are redacted from configuration and log previews by default. Use --no-redact only in a trusted local terminal when the raw value is genuinely required.

What install lanes are supported?

Ubuntu is the primary install lane. AlmaLinux, Rocky Linux, and RHEL-family servers are supported through the RHEL-family lane. OpenZero and ZeroMint AIOS servers use the OpenZero AIOS lane. Existing-panel takeover is treated as a migration workflow: run preflight first, verify off-server backups, then approve the replacement plan deliberately.

zerothink fwp install --server-mode ubuntu --hostname panel.example.com --email admin@example.com --dry-run zerothink fwp install --server-mode rhel-family --hostname panel.example.com --email admin@example.com --preflight-only zerothink fwp install --server-mode openzero-aios --hostname web.example.com --email admin@example.com --dry-run
What commands should I run first?

Start with zerothink fwp status, then zerothink fwp doctor --verbose. For automation use zerothink fwp health --json. Before maintenance, preview zerothink fwp backup --path /opt/freewebpanel --dry-run.

Zero Library + Labs

ZeroThink now has a deterministic library layer in front of the model. It uses normal code to index, search, and summarize your own folders before the AI is called, so routine lookup work can happen without spending model tokens. When the agent needs context, it receives a compact evidence pack instead of whole folders.

Zero Library

Upload notes, code, logs, docs, FASTA/FASTQ files, raw genotype exports, VCF files, or project references at /library. Each library is account-private: files live in a user-scoped server directory, the public web cannot browse storage, and search only reads that user's own index. In Studio or the CLI, mention @library when you want Agent Zero to attach only the most relevant snippets.

DNA Lab

/dna is now a one-click DNA evidence lab. Users upload a MyHeritage, 23andMe, Ancestry-style, CSV/TSV, raw, genome, or VCF file, then press Run Full DNA Report. ZeroThink returns plain-English cards, a signal wheel, an Evidence Ledger, Markdown/PDF export, and a DNA Agent follow-up box that receives summaries only, not raw genotype rows. Under the hood, ZDNA-MAP v1.1 scores raw-file quality, guesses genome build conservatively, tracks duplicates/chromosome coverage, prepares health research evidence cards, creates confidence-bounded heritage/genetic-affinity lenses, and can build optional GEDCOM/story-based Lineage Clues. The local data-pack path supports ClinVar, GWAS Catalog, PharmGKB/CPIC, HPO, UCSC liftover, 1000 Genomes/gnomAD-lite reduced panels, and Wikidata lineage subsets when installed. The Health lane does not diagnose or advise treatment. The Heritage lane does not invent exact ethnicity percentages or identity claims. The Lineage lane does not prove royal ancestry from DNA alone.

Media Lab

/media is now a downloadable Media Studio: AI voice MP3 generation, GPT Image PNG generation, xAI Grok Imagine Pro video jobs, SeedDance / BytePlus Ark cinematic video tasks, legacy Sora fallback, MP4 download links, and a browser-local asset shelf. Video generation is Pro-only; users save xAI and SeedDance keys in Vault Keys when they want their own provider billing.

CLI Commands

Agent Zero includes the same idea locally: zerothink library add ., zerothink library search "query", zerothink library context "bug", zerothink research paper "topic" --source ./papers --library, and zerothink dna analyze sample.fasta. Deeper AlphaGenome execution stays on the website/server side because biological API keys should remain centrally controlled rather than scattered across user terminals.

Security Boundary

The library accepts only safe text/code/sequence file types, blocks direct storage browsing, ignores dangerous archive execution paths, and keeps generated context compact. It helps the agent read better; it does not execute uploaded files.

ZMath Agent

/zmath turns Zero Boundary Algebra into a practical green agent rather than a decorative symbol page. It runs a deterministic modulo-9 engine for text, numbers, protocol steps, filenames, uploaded file previews, and research notes before an LLM is needed.

Strict Math Core

The formal core is Z/9Z, the triadic subgroup {0,3,6}, rotation x -> x + 3 mod 9, and the mirror operator x -> 8x mod 9 = -x mod 9. This keeps the agent honest and useful.

Useful Output

ZMath now answers like a normal agent first, then places the lab tools underneath. It returns parsed residues, balanced notation, reset/mirror traces, deterministic ZM9 fingerprints, state-machine JSON, practical software patterns, file profiles, and downloadable markdown reports. It is useful for workflow design, reset logic, checksum tags, reversible UI states, encryption handoff metadata, and symbolic research organization.

ZME1 Encryption Files

The ZMath page can create portable .zme1 files locally in the browser. It uses browser WebCrypto with AES-GCM-256 and PBKDF2-SHA256, plus optional pattern-image and Z-Pepper factors. The password, pattern file, and plaintext are not uploaded to ZeroThink. The ZMath packet stored in metadata is for deterministic workflow/fingerprint context, not a claim of extra cryptographic magic.

Truth Boundary

The -0, +0, and infinity labels are state annotations layered on top of modular arithmetic. ZMath does not pretend they are standard numeric residues; it uses them to preserve transition direction in protocols and research notation.

ZeroThink Logic

ZeroThink is a proprietary reasoning architecture, not a claim that raw hidden chain-of-thought should be exposed. The private method stays sealed. Studio presents a concise ZeroThink Reasoning Brief so the user can inspect the decision without receiving private prompts, constants, token-by-token working, or internal framework details.

Full ZeroThink Logic remains part of the Sovereign Pro tier. The visible brief is designed for useful scrutiny: evidence, alternatives, uncertainty, impact, the selected decision, and the next action.

Frame + Evidence

States the real problem, constraints, success condition, strongest available facts, retrieved context, calculations, and source limitations.

Counterpoint + Uncertainty

Surfaces the strongest credible alternative or failure mode, then identifies what remains unknown, unverified, assumed, or time-sensitive.

Impact + Decision

Checks likely harms, stakeholders, reversibility, and downstream effects before stating the chosen approach and one concrete next step.

API Configuration

To activate the Scout Node (Internet Search), the premium model engines, or the new Quantum lane, you must obtain API keys from the respective providers.

Groq Cloud (Recommended / Free)
Cost: Free Beta (High Limits)
Steps:
1. Go to console.groq.com
2. Sign up with Email/Google.
3. Click "Create API Key".
4. Paste into the ZeroThink Vault under "Groq API", or use zerothink key set groq for local direct mode in the CLI.
5. If you already export GROQ_API_KEY in your shell, the CLI can auto-detect it without Google login.

Current ZeroThink Groq menu: openai/gpt-oss-120b, groq/compound, groq/compound-mini, openai/gpt-oss-20b, qwen/qwen3.6-27b, llama-3.1-8b-instant, and allam-2-7b.
Deprecation note: Groq email notices dated 17 June 2026 say qwen/qwen3-32b and meta-llama/llama-4-scout-17b-16e-instruct decommission on 17 July 2026, and llama-3.3-70b-versatile decommissions on 16 August 2026. ZeroThink hides these choices now and routes old selections to openai/gpt-oss-120b. Groq's deprecation docs also point old Kimi K2 and Llama 4 Maverick usage at openai/gpt-oss-120b.
NVIDIA NIM (Free Credits)
Cost: 1,000 Free Credits on Signup
Steps:
1. Go to build.nvidia.com
2. Click "Login" -> Create Account.
3. Click "Get API Key" (Top Right).
4. Paste into the ZeroThink Vault under "NVIDIA NIM", or use zerothink key set nvidia for local direct mode in the CLI.
5. If you already export NVIDIA_API_KEY in your shell, the CLI can auto-detect it without Google login.
IonQ Quantum Cloud (Quantum Lane / Pro)
Cost: Free account available, quantum compute and org features vary by plan
Steps:
1. Create an IonQ Quantum Cloud account through IonQ Quantum Cloud.
2. Open the API Keys page in the IonQ cloud app and create a new key.
3. Save it immediately. IonQ documents that the full key value is only shown at creation time.
4. Paste it into the ZeroThink Vault under IonQ Quantum Cloud Key.
5. Keep your Groq API key saved too, because the Quantum lane uses Groq GPT-OSS 120B for reasoning and IonQ for live quantum-cloud telemetry.

How ZeroThink uses it: ZeroThink authenticates to IonQ using the documented Authorization: apiKey ... pattern, verifies the key session, pulls backend context, and can submit small simulator proof jobs in low-usage mode so the Quantum agent can reason against real IonQ state instead of pretending a quantum backend exists. Studio offers Auto Job, Fresh Proof Job, and Telemetry Only modes.
IBM Quantum / Qiskit (Qiskit Lane / Pro)
Cost: Local Qiskit simulation is local software; IBM Quantum Runtime and hardware access depend on the user's IBM Quantum plan.
Steps:
1. Create or open an IBM Quantum account at quantum.cloud.ibm.com.
2. In IBM Quantum, use the account switcher in the header to select the correct account and region before copying credentials.
3. From the IBM Quantum dashboard, create or reveal your API key, copy it once, and keep it in a private password manager. IBM treats the token as confidential; do not paste it into public code, screenshots, or chats. The same API key can authenticate to any IBM Quantum region.
4. Optional: open the Instances page, find the runtime instance you want, copy its CRN or instance name, and save it only if your account needs a specific Runtime instance.
5. Optional: choose a region such as us-east or eu-de. IBM ignores the region when a specific instance/CRN is supplied.
6. Paste the API key into Neural Vault -> IBM Quantum Token. Paste the instance/CRN and region only if you need Runtime/backend context.
7. Keep your Groq API key saved too, because ZeroThink uses Groq GPT-OSS 120B to explain the Qiskit calculation packet.

How ZeroThink uses it: The Qiskit lane calls a server-side Python worker. With Python 3.10+ and qiskit installed, it runs local Qiskit calculation packets. With qiskit-ibm-runtime and the user's IBM token, it can check IBM Runtime/backend context. The default Studio mode is local simulation and does not submit IBM hardware jobs. Use the algorithm selector for Bell, GHZ, Grover, QAOA MaxCut, VQE Toy, QFT, or Zero Pattern.

Qiskit algorithm selector:
ZERO PATTERN: ZeroThink's prompt-seeded research lane. It turns the user's prompt into a repeatable quantum-style packet for custom Zero research and pattern reasoning.
BELL: A two-qubit entanglement correlation test. Use it as the fastest smoke test or when the question is about paired states, symmetry, or correlation.
GHZ: A multi-qubit shared-state circuit. Use it for consensus, shared-state, distributed-correlation, and "many parts acting as one" style prompts.
GROVER: A toy search/amplification circuit. Use it for candidate finding, option selection, lookup-style reasoning, or demonstrating quantum search intuition.
QAOA MAXCUT: A small graph optimization preset. Use it for routing, scheduling, grouping, clustering, partitioning, allocation, and other optimization examples.
VQE TOY: A small variational eigensolver-style ansatz. Use it for energy-minimization, chemistry-inspired, materials-inspired, or parameter-tuning research demos.
QFT: Quantum Fourier Transform. Use it for phase, periodicity, frequency, signal, wave, and number-pattern style questions.

Qiskit mode selector: QISKIT LOCAL builds a local calculation/simulation packet and does not need an IBM token. QISKIT BACKEND is for IBM Runtime/backend context and needs the user's own IBM Quantum token, plus instance/CRN and region when their IBM account requires them. ZeroThink should keep hardware job submission explicit and labelled instead of quietly spending quantum credits.

Server setup: Current Qiskit packages require Python 3.10 or newer. Install with python3.10 -m venv quantumibm-python/.venv, then quantumibm-python/.venv/bin/python -m pip install -r quantumibm-python/requirements.txt. If the web server uses a custom Python path, set QISKIT_PYTHON. If the host disables PHP process spawning, ZeroThink falls back to a deterministic PHP packet so the lane keeps working, but real Qiskit execution requires an enabled Python worker or sidecar service.
Google Gemini (Free Tier)
Cost: Free Tier Available / Pay-as-you-go
Steps:
1. Go to aistudio.google.com
2. Click "Create API Key".
3. Paste into the ZeroThink Vault under "Gemini API".
xAI (Grok)
Cost: Paid (Pre-load Credits)
Steps:
1. Go to console.x.ai
2. Add Billing Details.
3. Generate Key and paste into Vault under "xAI API".
OpenAI (GPT-5.5 / GPT-5.4 / GPT-5.4 Mini / GPT-5.4 Nano)
Cost: Paid (Pay-as-you-go)
Steps:
1. Go to platform.openai.com
2. Create new Secret Key.
3. Paste into Vault under "OpenAI API".
OpenZero Local (Pro / 5 Shared Messages / Bring Your Own Node)
Cost: ZeroThink Pro required. When enabled, the shared ZeroThink OpenZero gateway is limited to 5 messages per Pro account to protect shared CPU resources. Continued use should come from the user's own OpenZero machine/server key through a server-side registered gateway.
Current local model policy: ZeroThink only exposes small OpenZero local aliases under 15 GB. The current safe lane is glm4:9b-q5 for GLM 4 9B Q5, with hermes3:8b-q5 and gemma4:e4b fallbacks. The working GLM 4 Q5 GGUF is about 6.6 GB. GLM 5.2 is not a safe local fit on the current OpenZero VM because complete GGUF packages are hundreds of GB.
Steps:
1. In Studio, choose an OPENZERO LOCAL model to use the shared trial if the gateway is enabled and you have no key saved.
2. After the 5-message trial, install OpenZero on your own Linux machine or server from openzero.talktoai.org/manual.
3. Create an OpenZero API key on your node and keep it private.
4. Paste the key into Neural Vault -> OpenZero Machine API Key.
5. ZeroThink web does not accept browser-supplied OpenZero URLs. User nodes must connect through a safe server-side gateway/registration path rather than arbitrary client-controlled upstream URLs.
Featherless Hosted Models (Pro / Paid Hosted Key)
Cost: Featherless account/key required; larger hosted models may need a paid Featherless plan.
Steps:
1. Create or open a Featherless account at featherless.ai.
2. Create an API key in Featherless and keep it private.
3. Paste it into Neural Vault -> Featherless API Key.
4. Choose a FEATHERLESS HOSTED model in Studio.

Current allowlist: shafire/talktoaiZERO, zai-org/GLM-5.2, zai-org/GLM-4.5, Qwen/Qwen3-Coder-480B-A35B-Instruct, deepseek-ai/DeepSeek-V3.2, and moonshotai/Kimi-K2-Instruct.
Boundary: Featherless is the right lane for very large hosted models such as GLM 5.2. Those models are not downloaded onto the local ZeroThink/OpenZero CPU box.
Serper (Web Search)
Cost: 2,500 Free Queries
Steps:
1. Go to serper.dev
2. Sign up.
3. Copy API Key.
4. Paste into Vault under "Serper Web Key".
ZERO SYSTEM v35 // SOVEREIGN ARCHITECTURE
© 2026 Shaf Brady / TalkToAi