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
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.
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.
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 requests work best when the user states audience, sections, evidence needs, caveats, and export purpose. Serious reports should be reviewed before sharing.
Access Tiers
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
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.
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.
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.
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.
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.
$AI Token CA: dHdkhZsmBQhXjQoKbkyajZ3Ff4W2XumGyVJX4jypump
$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
| Provider | Model Name | Specs | Access | Best Use |
|---|---|---|---|---|
| GROQ | GPT-OSS 120B / GPT-OSS 20B / Compound | Current fast cloud stack | Free | General reasoning, Oracle, broad strategic work |
| GROQ | Qwen 3.6 27B / Llama 3.1 8B Instant / ALLaM 2 7B | Current Groq open-weight and specialist lane | Free | Coding, structured analysis, fast iterations, bilingual Arabic-English work |
| GROQ | Legacy IDs: Llama 3.3 70B, Llama 4 Scout/Maverick, Qwen3 32B, Kimi K2 | Hidden from pickers and routed to GPT-OSS 120B when old selections appear | Free | Migration safety only; use GPT-OSS 120B or Qwen 3.6 for new work |
| NVIDIA | Qwen 3 Coder 480B / Codestral 22B / Devstral 2 | Heavy coding + instruct | Free | Large code work, technical drafting, deep analysis |
| NVIDIA | Gemma 4 31B / Gemma 3n E4B / DeepSeek V3.2 / Llama 3.3 70B | Current NVIDIA frontier set | Free | Long-form reasoning, multilingual work, coding and research |
| xAI | Grok 4.3 / Grok Build 0.1 / Grok Imagine API | Current premium xAI line | Pro | Reasoning, coding, live premium use |
| Gemini 3.5 Flash / Gemini 3.1 Pro / Gemini 3.1 Flash-Lite / Gemini 2.5 | Multimodal + long-context | Pro | Large documents, deeper analysis, mixed text/media work | |
| OPENAI | GPT-5.5 / GPT-5.4 / GPT-5.4 Mini / GPT-5.4 Nano | Current frontier + lower-cost variants | Pro | Optional premium lane when you switch away from the default Groq route |
| OPENZERO | GLM 4 9B Q5 / Hermes 3 8B Q5 / Gemma 4 E4B | Local/self-hosted aliases capped below 15 GB; current GLM 4 Q5 GGUF is about 6.6 GB | Pro | Private local CPU tasks, small automation, dev/research drafts; 5 shared messages when enabled, then BYO registered OpenZero key |
| FEATHERLESS | TalkToAI ZERO / GLM 5.2 / GLM 4.5 / Qwen3 Coder / DeepSeek / Kimi | Hosted OpenAI-compatible model lane; large models run on Featherless, not the local ZeroThink server | Pro | Hosted large-model experiments with the user's own Featherless account/key |
| QUANTUM | Groq GPT-OSS 120B + IonQ Cloud | Special research agent with backend telemetry and simulator job records | Pro | Quantum-assisted planning, hardware-aware research, backend-aware synthesis |
| QISKIT | Groq GPT-OSS 120B + IBM Qiskit | Qiskit calculation packets with optional IBM Runtime/backend context | Pro | Bell/GHZ, Grover, QAOA, VQE, QFT, and prompt-seeded Zero pattern experiments |
Oracle Desk
The Oracle route is tuned for both crypto scenarios and broader strategic calls. Modes include crypto, general, launch, and risk.
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.
The Oracle page includes a Solana support card so people who use the desk heavily can donate directly to the ZeroThink build.
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
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.
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.
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.
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.
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.
Quantum access is reserved for Pro. Free accounts stay on the fast open-weights lanes and do not unlock the IonQ-backed agent.
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.
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.
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
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.
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.
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.
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.
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.
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.
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
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
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.
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.
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.
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
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.
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.
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.
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.
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
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.
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 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 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.
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.
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.
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.
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.
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.
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.
States the real problem, constraints, success condition, strongest available facts, retrieved context, calculations, and source limitations.
Surfaces the strongest credible alternative or failure mode, then identifies what remains unknown, unverified, assumed, or time-sensitive.
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)
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)
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)
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)
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)
Steps:
1. Go to aistudio.google.com
2. Click "Create API Key".
3. Paste into the ZeroThink Vault under "Gemini API".
xAI (Grok)
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)
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)
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)
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)
Steps:
1. Go to serper.dev
2. Sign up.
3. Copy API Key.
4. Paste into Vault under "Serper Web Key".
© 2026 Shaf Brady / TalkToAi