Docs are under construction. Content may be incomplete or change.

Tako Docs

Page type: Overview
On this page

Tako is an atomistic simulation package that runs entirely in your browser. It combines structure building and visualization, quantum-chemical and machine-learned calculations, and a built-in research agent in one workspace.

Every calculation executes locally in your browser — your structures, results, and files never reach our server. Sharing is peer-to-peer: shared workspaces travel directly between browsers, so we cannot see what you share. The optional agent works with your own ChatGPT subscription for fast chemical modeling and research, and the scripts and calculations it produces still run locally on your machine.

Tako currently supports machine-learned interatomic potentials (MLIPs) and the GFN2-xTB level of theory; g-xTB and GGA-level density functional theory are under active development.

Start with a short tutorial if you are new; use the task guides when you already know what you want to accomplish.

Choose your starting path

New to Tako? Follow one default sequence: spend two minutes on Before You Start, complete the Five-Minute Ethanol Calculation, then use the Workspace Tour to place what you just used in the larger interface. Experienced users can jump directly to a task guide.

I want to…Start hereTime
Run my first molecular calculationFive-Minute Ethanol Calculation5–10 min
Understand the interfaceWorkspace Tour10 min
Optimize a molecule and calculate vibrationsMolecule Tutorial: Water10–20 min
Relax a crystal and inspect phonons/DOSCrystal Tutorial: Silicon20–40 min
Decide which model is appropriateChoosing a Method10 min
Automate a multi-step workflowWrite Your First Tako Script15 min
Ask the built-in Agent to produce a workflowAgent Guide10 min setup
Inspect complete scientific studiesScientific ExamplesVaries

Before a long calculation, read Before You Start for model downloads, local storage, browser memory, privacy, and backup expectations.

What the workspace looks like

The workspace combines an Explorer file tree, structure tabs, a three-dimensional viewport, editing and calculation tools, and a results panel. Calculations create ordinary folders containing logs, structured results, trajectories, spectra, plots, or volumetric data.

Tako workspace with the Explorer, toolbars, structure viewport, and results panel

The Workspace Tour explains each region. You do not need to memorize the interface before taking the first tutorial.

What Tako can calculate

Scientific questionTako operationTypical output
What are the energy and forces at this geometry?Single PointEnergy, forces, stress, and method-dependent electronic properties
What nearby geometry is stable under this model?OptimizationRelaxed structure, trajectory, energy trace, convergence data
How does the structure move with time?Molecular DynamicsTrajectory and thermodynamic traces
What are the molecular normal modes?VibrationFrequencies, modes, IR/Raman data
Is a crystal dynamically stable?PhononPhonon bands, density of states, displaced structures
What powder pattern should a structure produce?XRDIndexed or Debye diffraction pattern
What electronic excitations does a molecule show?sTDAExcitations and UV-Vis spectrum
What path connects two structures?Reaction Path / TSNEB path, barrier, saddle refinement, vibration check

Calculators include semi-empirical GFN2 methods and machine-learned interatomic potentials. Select a model according to chemical coverage, periodicity, requested properties, and the evidence level the result needs.

Where your work runs

Normal calculations run in sandboxed workers inside the browser. Structures, settings, scripts, and results stay in the local workspace, while calculation engines and model weights download as static assets and are cached for later offline use.

Tako Script uses the same public calculation operations as the visible setup dialogs. The optional Agent sends model requests through your connected Codex account, but the scripts and atomistic calculations it requests still execute locally. How Tako Runs Calculations explains these boundaries in detail.

Scientific scope

Tako is designed for rapid screening, prototyping, teaching, method development, and reproducible browser-local workflows. It is not a density-functional-theory code.

Use these rules throughout the documentation:

  • Compare energies only when reference states, calculator, charge/spin, and relevant settings are consistent.
  • Reject unconverged results rather than reporting the numbers they produce.
  • Treat electronic energies, binding energies, and barriers as distinct from finite-temperature free energies.
  • Check whether the model covers the elements, bonding, and structural regime being studied.
  • Escalate important conclusions to a validated higher-level method or experiment.

Every scientific example is labeled as a demonstration, educational workflow, screening calculation, or validated benchmark so its claim strength is visible before the procedure.