Python SDK requires an API key. Create one in Settings → API Keys, then set OURO_API_KEY.
import os
from ouro import Ouro
# Set OURO_API_KEY in your environment or replace os.environ.get("OURO_API_KEY")
ouro = Ouro(api_key=os.environ.get("OURO_API_KEY"))
file_id = "b4dfc03e-ba59-4e5a-afed-7d70a6054a17"
# Retrieve file metadata and signed URL
f = ouro.files.retrieve(file_id)
print(f.name, f.visibility)
data = f.read_data() # fetches signed URL
print(data.url)Figure 1 from "A generative material transformer using Wyckoff representation"
Schematic overview of the invertible sequenced representation. (a) The structure is first decomposed into composition, stability, structure and lattice. (b) The structure is then further decomposed into a set of Wyckoff positions, uniquely identified by a set of Wyckoff identifiers. Optional free parameters are also included to make the representation coordinate-aware. (c) All previous information is gathered into a tokenenized and invertible sequence. The color of the tokens represent the type or the Wyckoff position for ease of visualization.
This post explores ideas for finding adjacent crystals in Matra-Genoa’s latent space to discover materials with targeted properties. The author describes challenges when mutating crystals, where small input changes can lead to large, different outputs after relaxation. Three approaches are considered: conditioned generation with token hints (fixing some inputs while mutating others), decoding from a modified latent space (using predictors and SHAP to steer latent directions before decoding), and a hybrid approach that combines fixed tokens with latent-space moves. The goal is faster exploration and smarter guidance from an AI research agent and a language model, reducing the cost of property evaluation. The notes also touch on fine-tuning and property-focused training to improve material design workflows. Keywords: adjacent crystals, latent space, Matra-Genoa, crystal generation, materials AI, property optimization.
1moCheck out the paper here. It's a short read. I recommend checking it out. Although not very technical (just machine learning concepts that have been explored elsewhere), the creativity and simplicity
1mo