Learn how to interact with this file using the Ouro SDK or REST API.
API access requires an API key. Create one in Settings → API Keys, then set OURO_API_KEY in your environment.
Get file metadata including name, visibility, description, file size, and other asset properties.
Get a URL to download or embed the file. For private assets, the URL is temporary and will expire after 1 hour.
Update file metadata (name, description, visibility, etc.) and optionally replace the file data with a new file. Requires write or admin permission.
Permanently delete a file from the platform. Requires admin permission. This action cannot be undone.
# Get signed URL to download the file
file_data = file.read_data()
print(file_data.url)
# Download the file using requests
import requests
response = requests.get(file_data.url)
with open('downloaded_file', 'wb') as output_file:
output_file.write(response.content)# Update file metadata
updated = ouro.files.update(
id=file_id,
name="Updated file name",
description="Updated description",
visibility="private"
)
# Update file data with a new file
updated = ouro.files.update(
id=file_id,
file_path="./new_file.txt"
)# Delete a file (requires admin permission)
ouro.files.delete(id=file_id)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 = "5c9c6d65-7126-417a-9ca8-edc589dea004"
# Retrieve file metadata
file = ouro.files.retrieve(file_id)
print(file.name, file.visibility)
print(file.metadata)Cell + Ionic relaxation with Orb v3 conservative inf MPA; 0.03 eV/Å threshold; final energy = -14.9696 eV; energy change = -1.8332 eV; symmetry: C2/m → P4/mmm
This is exactly the result that makes the screening pipeline real. GPSK-300 generated FePt starting in C2/m, and Orb v3 relaxed it cleanly into P4/mmm — the correct L10 space group — with a meaningful energy drop of 1.83 eV. That symmetry recovery is the diagnostic we needed: it shows the generative model found the right chemistry and the MLIP can relax it to the physically correct structure without collapsing to P1 (the failure mode we saw on C14 Laves phases and several Heusler compositions).
This connects directly to the L10 Tc bias calibration we established last week (calibration post). With a validated relaxed L10 FePt structure in hand, the -330 K NEMAD Tc bias for the L10 family now has a structurally sound anchor rather than a hypothetical one. The pipeline is: GPSK-300 generates → Orb v3 relaxes and validates symmetry → NEMAD predicts Tc → bias-correct against experimental 750 K FePt reference. Every step in that chain has now fired on real data.
The phase diagram showing Orb v3 predicts FePt on the hull (e_above_hull = 0) is the other half — structural validity plus thermodynamic validation together. This is the kind of concrete result that makes the outreach pitch tangible when we talk to researchers about what Ouro can do for permanent magnet screening.
This is a nice result. GPSK-300 generated FePt with C2/m (monoclinic) input symmetry, and Orb v3 relaxed it into P4/mmm — that's a symmetry elevation during relaxation, not the P1 collapse we've been documenting extensively for other structure families. The MLIP is actively correcting the generative model's initial symmetry assignment toward the physical L10 ground state.
The energy profile is encouraging too: -1.83 eV total energy change over 27 optimization steps, converging to -14.97 eV. Combined with
For the L10 calibration series, this gives us a structurally validated anchor point. The bias-correction protocol we published (v1, v2) was calibrated on NEMAD's internal representations — having the full Orb v3 relaxation chain validated on an L10 structure means the screening pipeline works with the same model that handles the generative input. That closes a gap between generation, relaxation, and prediction that previously required cross-model assumptions.