---
orphan: true
html_theme.sidebar_secondary.remove: true
sd_hide_title: true
html_class: landing-page
og:title: "Tesseract — Universal components for differentiable scientific computing"
og:description: "Optimize, calibrate, and train through solvers in any language or framework. Tesseract wraps any software behind a typed interface with derivative endpoints, runs it in its own process, and hands it to jax.grad or torch.autograd as a single differentiable operation. Open source."
og:image: _static/social-card.png
og:image:alt: Tesseract logo
og:image:width: "1200"
og:image:height: "630"
myst:
html_meta:
twitter:card: summary_large_image
---
# Tesseract
::::::{div} landing-hero
:::{div} landing-hero-logo
```{image} static/logo-light.png
:alt: Tesseract
:width: 180px
:class: landing-logo only-light
```
```{image} static/logo-dark.png
:alt: Tesseract
:width: 180px
:class: landing-logo only-dark
```
:::
:::::{div} landing-hero-text
:::{div} landing-hero-eyebrow
Universal components for differentiable scientific computing
:::
:::{div} landing-hero-headline
Optimize, calibrate, and train through solvers in any language or framework
:::
:::{div} landing-hero-subtitle
Tesseract wraps any software behind a typed interface with derivative endpoints, runs it in its own process, and hands it to `jax.grad` or `torch.autograd` as a single differentiable operation.
Open source, published in [JOSS](https://doi.org/10.21105/joss.08385).
:::
:::::
:::{div} landing-cta
{bdg-ref-primary-line}`Get started `
{bdg-ref-primary-line}`Documentation `
{bdg-ref-primary-line}`Demos `
{bdg-link-primary-line}`GitHub `
:::
::::::
:::{div} landing-divider
:::
## Why Tesseract
:::{div} section-intro
Tesseract is for differentiable programs that need to reach outside their own framework: solver-in-the-loop training, calibration and inverse problems, simulation-based inference, and shape optimization through real engineering tools.
:::
::::{grid} 1 2 3 3
:gutter: 4
:::{grid-item-card} Wrap tools you can't replace
:class-card: feature-card
Get validated legacy codes, {doc}`commercial CAD and FEA `, and closed-source binaries to play well alongside modern differentiable components.
:::
:::{grid-item-card} Call it from JAX and PyTorch
:class-card: feature-card
{doc}`Fortran `, Julia, or C++ code becomes an operation that `jax.grad` and `torch.autograd` differentiate like native code.
:::
:::{grid-item-card} Verify gradients
:class-card: feature-card
{doc}`Test every derivative ` against finite differences before an optimizer relies on it.
:::
:::{grid-item-card} Fast process interfaces
:class-card: feature-card
Each component runs in its own process, with its own dependencies.
Shared memory and GPU-native transport keep calls {doc}`cheap `.
:::
:::{grid-item-card} Mix gradient strategies
:class-card: feature-card
Combine adjoints, forward- and reverse-mode autodiff, and finite differences in {doc}`one end-to-end gradient `.
:::
:::{grid-item-card} Hand it to someone else
:class-card: feature-card
OpenAPI schemas and API docs are auto-generated from your code, and `tesseract build` takes it to other machines as a {doc}`container image `.
:::
::::
:::{div} landing-divider
:::
## How it works
:::{div} section-intro
Define a differentiable component in `tesseract_api.py`, run it in its own process,
and call it, including its gradients, from Python, JAX, or PyTorch.
To run it on another machine, package the same file as a container image.
:::
:::::::{grid} 1 1 2 2
:gutter: 3
:::::{grid-item}
:class: howto-define
**Define a Tesseract**
```python
# tesseract_api.py
from pydantic import BaseModel
from tesseract_core.runtime import (
Array, Differentiable, Float32, ShapeDType
)
class InputSchema(BaseModel):
x: Differentiable[Array[(None,), Float32]]
class OutputSchema(BaseModel):
y: Differentiable[Array[(None,), Float32]]
def apply(inputs: InputSchema) -> OutputSchema:
# Call your solver, mesh generator,
# or surrogate here
return OutputSchema(y=inputs.x**2)
def vector_jacobian_product(
inputs, vjp_inputs, vjp_outputs, cotangent_vector
):
# Hand-written, autodiff, adjoint solve,
# finite differences, ...
return {"x": 2 * inputs.x * cotangent_vector["y"]}
def abstract_eval(abstract_inputs):
# Output shapes from input shapes
return {"y": ShapeDType(
shape=abstract_inputs.x.shape, dtype="float32"
)}
```
:::::
:::::{grid-item}
**Use it**
::::{tab-set}
:::{tab-item} Python SDK
```python
from tesseract_core import Tesseract
with Tesseract.from_source("tesseract_api.py") as t:
result = t.apply({"x": [3.0]})
# result["y"] => array([9.])
vjp = t.vector_jacobian_product(
{"x": [3.0]},
vjp_inputs=["x"], vjp_outputs=["y"],
cotangent_vector={"y": [1.0]},
)
# vjp["x"] => array([6.])
```
:::
:::{tab-item} JAX
```python
import jax
import jax.numpy as jnp
from tesseract_core import Tesseract
from tesseract_jax import apply_tesseract
with Tesseract.from_source("tesseract_api.py") as t:
f = lambda x: apply_tesseract(t, {"x": x})["y"].sum()
jax.jit(f)(jnp.array([3.0]))
# => Array(9.)
jax.grad(f)(jnp.array([3.0]))
# => [6.]
```
:::
:::{tab-item} PyTorch
```python
import torch
from tesseract_core import Tesseract
from tesseract_torch import apply_tesseract
with Tesseract.from_source("tesseract_api.py") as t:
x = torch.tensor([3.0], requires_grad=True)
out = apply_tesseract(t, {"x": x})
# out["y"] => tensor([9.])
out["y"].sum().backward()
# x.grad => tensor([6.]) (via the VJP endpoint)
```
:::
:::{tab-item} Check & package
```bash
# Compare the VJP against finite differences
$ TESSERACT_API_PATH=tesseract_api.py \
tesseract-runtime check-gradients \
'{"inputs": {"x": [1.0, 2.0, 3.0]}}'
✅ Gradient check for vector_jacobian_product passed ✅
# Build a container image (requires Docker)
$ tesseract build .
$ tesseract run my-tesseract apply \
'{"inputs": {"x": [3.0]}}'
```
:::
::::
:::::
:::::::
:::{div} landing-cta
{bdg-ref-primary-line}`Get started `
{bdg-ref-primary-line}`Overview `
{bdg-ref-primary-line}`When to use Tesseract `
:::
:::{div} landing-divider
:::
## Built with Tesseract
::::{grid} 1 2 3 3
:gutter: 3
:::{grid-item-card} PRISMO
:link: https://github.com/benvial/prismo
:class-card: demo-card
:img-top: img/gallery/prismo.jpg
A Julia semiconductor solver and a FEniCS optics solver in one JAX gradient,
reaching more than five times the optical phase shift of the starting design.
:::
:::{grid-item-card} δSnowSac
:link: https://github.com/kasProg/dSnowSac
:class-card: demo-card
:img-top: img/gallery/dsnowsac.jpg
A PyTorch network learns to calibrate NOAA's operational Fortran models,
Snow-17 and SAC-SMA, with gradients flowing through the untouched Fortran.
:::
:::{grid-item-card} Rocket grid fins
:link: blog/2025-11-28-rocket-fin-optimization
:link-type: doc
:class-card: demo-card
:img-top: img/gallery/rocket-fin.jpg
Ansys SpaceClaim geometry and PyMAPDL structural analysis in one optimization loop,
giving a design 24% stiffer than the baseline at the same mass.
:::
:::{grid-item-card} Differentiable Silicon
:link: https://github.com/hozaifa1/differentiable-silicon
:class-card: demo-card
:img-top: img/gallery/differentiable-silicon.jpg
Sentaurus TCAD, a closed-source binary driven over SSH, differentiated with
finite differences and Broyden updates to tune a transistor for a spiking network.
:::
:::{grid-item-card} NeuroLocate
:link: https://github.com/BrainCapture/NeuroLocate
:class-card: demo-card
:img-top: img/gallery/neurolocate.jpg
A PyTorch network proposes EEG sources, and JAX refines them with gradients
through OpenMEEG, a C++ boundary element solver with no autodiff of its own.
:::
:::{grid-item-card} Mosaic
:link: https://github.com/pasteurlabs/mosaic
:class-card: demo-card
:img-top: img/gallery/mosaic.jpg
Solvers in C++, Julia, JAX, and PyTorch, from deal.II and OpenFOAM to JAX-FEM and XLB,
behind one Tesseract interface, so a single harness can compare their gradients and cost on shared tasks.
:::
::::
:::{div} landing-cta
{bdg-ref-primary-line}`Demos & tutorials `
:::
:::{div} landing-divider
:::
## The Tesseract ecosystem
:::{div} section-intro
Tesseract Core is the foundation. Additional packages extend its capabilities.
:::
::::{grid} 1 1 3 3
:gutter: 3
:::{grid-item-card} Tesseract Core
:link: content/introduction/index
:link-type: doc
:class-card: ecosystem-card
CLI, Python SDK, and runtime for wrapping differentiable components
and running them as subprocesses, containers, or remote services.
:::
:::{grid-item-card} Tesseract-JAX
:link: https://github.com/pasteurlabs/tesseract-jax
:class-card: ecosystem-card
Embed Tesseracts as JAX primitives. Fully compatible with `jit`, `vmap`,
and `grad`.
:::
:::{grid-item-card} Tesseract-Torch
:link: https://github.com/pasteurlabs/tesseract-torch
:class-card: ecosystem-card
Embed Tesseracts as PyTorch operators. Gradients flow through with
`torch.autograd`.
:::
::::
:::{div} section-intro
Also see [Tesseract-Streamlit](https://github.com/pasteurlabs/tesseract-streamlit) to generate web apps from Tesseracts,
and [cookiecutter-tesseract](https://github.com/pasteurlabs/cookiecutter-tesseract) for a multi-Tesseract project template.
:::
:::{div} landing-divider
:::
## Get involved
:::{div} section-intro
Wrap your solver or model as a Tesseract, or compose existing ones into a new pipeline.
[Show us what you built](https://si-tesseract.discourse.group/c/showcase/11), or help improve the project.
:::
:::{div} landing-cta
{bdg-link-primary-line}`GitHub `
{bdg-ref-primary-line}`Blog `
{bdg-link-primary-line}`Contributing `
:::
::::{div} landing-footer
::::{grid} 1 1 3 3
:gutter: 3
:::{grid-item}
**Project**
- {doc}`Get started `
- {doc}`Installation `
- {doc}`API reference `
- [JOSS paper](https://doi.org/10.21105/joss.08385)
- [Changelog](https://github.com/pasteurlabs/tesseract-core/releases)
:::
:::{grid-item}
**Community**
- [User Forum](https://si-tesseract.discourse.group/)
- {doc}`Blog `
- [GitHub](https://github.com/pasteurlabs/tesseract-core)
- [Contributing](https://github.com/pasteurlabs/tesseract-core/blob/main/CONTRIBUTING.md)
- [Code of conduct](https://github.com/pasteurlabs/tesseract-core/blob/main/CODE_OF_CONDUCT.md)
- [Report an issue](https://github.com/pasteurlabs/tesseract-core/issues)
:::
:::{grid-item}
**About**
- Created at [Pasteur Labs](https://pasteurlabs.ai)
- Open source — [Apache License](https://github.com/pasteurlabs/tesseract-core/blob/main/LICENSE)
:::
::::
::::