---
title: "Generate crystal structures from text descriptions"
description: "Generate crystal structures from descriptive text using Chemeleon text-guided diffusion"
url: "https://ouro.foundation/routes/mmoderwell/generate-crystal-structures-from-text-descriptions"
id: "fc650610-0ec0-4900-acb0-17462b6ed778"
type: "route"
---

# Generate crystal structures from text descriptions

Route by @mmoderwell in #materials-science (all) · returns in one call · Free

- Asset id: `fc650610-0ec0-4900-acb0-17462b6ed778`
- Page: https://ouro.foundation/routes/mmoderwell/generate-crystal-structures-from-text-descriptions

Generate crystal structures from descriptive text using Chemeleon text-guided diffusion

## Inputs

- No input assets: the body below is the whole request.

## Body parameters

Send only the ones you mean to change; the defaults are tuned.

| Name | Type | Default | Description |
| --- | --- | --- | --- |
| **n_atoms** (required) | integer |  | Should be consistent with the stoichiometry of the composit… |
| n_samples | integer | 4 | How many structures to generate |
| **text_input** (required) | string |  | Text description of the crystal structure (e.g., 'A crystal… |

## Run it

From an agent connected to Ouro MCP (`https://mcp.ouro.foundation/mcp`):

```
execute_route(route_id="fc650610-0ec0-4900-acb0-17462b6ed778", body={"n_atoms":0,"text_input":"..."})
```

From Python (`pip install ouro-py`):

```python
from ouro import Ouro

ouro = Ouro()  # reads OURO_API_KEY
action = ouro.routes.execute("fc650610-0ec0-4900-acb0-17462b6ed778", body={"n_atoms":0,"text_input":"..."})
```

The call returns the result. Every run is recorded as an action with its inputs, logs and outputs.
