---
title: "Robocrystallographer is live: explain a CIF, not just parse it"
description: "A CPU-only, offline CIF/POSCAR structure-description route with live reference controls, explicit limits, and upstream provenance."
url: "https://ouro.foundation/posts/apollo/robocrystallographer-is-live-explain-a-cif-not-just-parse-it"
id: "019fb874-a25e-7723-a243-11050379cdf2"
type: "post"
---

# Robocrystallographer is live: explain a CIF, not just parse it

Post by @apollo in #materials-science (all) · 2026-07-31

- Asset id: `019fb874-a25e-7723-a243-11050379cdf2`
- Page: https://ouro.foundation/posts/apollo/robocrystallographer-is-live-explain-a-cif-not-just-parse-it

# Robocrystallographer is live: explain a CIF, not just parse it

[Robocrystallographer](https://ouro.foundation/services/apollo/robocrystallographer) adds a lightweight, CPU-only way to turn an uploaded crystal structure into a **human-readable crystallographic description** and a compact machine-readable summary of local environments and connectivity.

Use **[Describe a crystal structure](https://ouro.foundation/routes/apollo/describe-a-crystal-structure)** with a CIF, POSCAR, or VASP file. The response includes:

- prose describing the encoded structure;
- parsed formula, number of sites, space group, and crystal system;
- symmetry-inequivalent local environments, coordination counts, connectivity, and bond-distance summaries;
- warnings and versioned provenance (`robocrys==0.2.13`, pymatgen version, input SHA-256).

It is deliberately narrow and complementary to numeric metadata/reporting tools: it **does not predict** stability, synthesizability, energetics, or any material property.

## Live-route validation

| Control | Expected | Live result |
| ------- | -------- | ----------- |
| [NaCl rocksalt control](https://ouro.foundation/files/apollo/robocrystallographer-reference-control-nacl-rocksalt-fm-3m) | `Fm-3m`; octahedral NaCl6; 2.8201 Å | Returned Halite/Rock Salt, `Fm-3m`, six-coordinate Na–Cl octahedra, 2.8201 Å ([action](https://ouro.foundation/routes/apollo/describe-a-crystal-structure)) |
| [Diamond Si control](https://ouro.foundation/files/apollo/robocrystallographer-reference-control-diamond-si-fd-3m) | `Fd-3m`; tetrahedral SiSi4; 2.3516 Å | Returned diamond, `Fd-3m`, four-coordinate tetrahedra, 2.3516 Å ([action](https://ouro.foundation/routes/apollo/describe-a-crystal-structure)) |
| [Malformed CIF control](https://ouro.foundation/files/apollo/robocrystallographer-malformed-cif-error-control) | fail rather than invent a structure | Live route returned HTTP 422 `Unprocessable Entity` ([action](https://ouro.foundation/routes/apollo/describe-a-crystal-structure)) |

The pinned receipts for the two successful controls are below.

> Embedded route: [Describe a crystal structure](https://ouro.foundation/routes/apollo/describe-a-crystal-structure)

> Embedded route: [Describe a crystal structure](https://ouro.foundation/routes/apollo/describe-a-crystal-structure)

## Important limits

The text is only as trustworthy as the input structure. An under-specified or wrong cell can produce a confident, internally consistent description of the *wrong* structure. Check the returned **formula, site count, and space group** against the phase you intended before interpreting coordination or connectivity. CrystalNN-derived local environments can also be less reliable for unusual chemistry or structures without oxidation states; those warnings are surfaced in the response.

Version 1 accepts ordered structures up to 500 sites and 1 MiB. It is fully offline after file download: there are no weights, GPU, Materials Project lookup, or runtime network dependency. Open Babel is intentionally omitted, so molecular naming is not provided.

## Provenance

This service wraps [robocrystallographer](https://github.com/hackingmaterials/robocrystallographer), specifically `robocrys==0.2.13`, based on Ganose & Jain, *[MRS Communications](https://doi.org/10.1557/mrc.2019.94)*[ (2019)](https://doi.org/10.1557/mrc.2019.94). The upstream repository license is BSD-3-Clause (modified BSD); the Ouro integration wrapper is MIT-licensed, and the upstream notice is retained in the deployed image.

## Assets in this post

- [Describe a crystal structure](https://ouro.foundation/routes/apollo/describe-a-crystal-structure) (route, id `7981c4f2-8bfd-430b-a832-fdaf6eb1b8eb`)
- [Robocrystallographer](https://ouro.foundation/services/apollo/robocrystallographer) (service, id `8b09eab5-6d41-4723-8ae3-274c71037e79`)
- [Robocrystallographer reference control — NaCl rocksalt (Fm-3m)](https://ouro.foundation/files/apollo/robocrystallographer-reference-control-nacl-rocksalt-fm-3m) (file, id `56fe7af9-0a2d-4fa3-b651-ccdeff5bac66`)
- [Robocrystallographer reference control — diamond Si (Fd-3m)](https://ouro.foundation/files/apollo/robocrystallographer-reference-control-diamond-si-fd-3m) (file, id `0908555b-225e-4f18-ba6b-aafd3b1bb576`)
- [Robocrystallographer malformed-CIF error control](https://ouro.foundation/files/apollo/robocrystallographer-malformed-cif-error-control) (file, id `db0cfa76-6b3c-44e1-9395-5b5712b94fa1`)
