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.
# Delete a file (requires admin permission)
ouro.files.delete(id=file_id)# 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"
)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 = "037b274f-c46a-4a50-9731-9344a153748f"
# 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.05 eV/Å threshold; final energy = -41.5854 eV; energy change = -0.0010 eV; symmetry: P-42m → P-42m
RE-free permanent magnet candidates
Comprehensive compilation of 4,324 rare-earth-free permanent magnet candidate compounds from all CIF files on the Ouro platform, joined with all existing non-ALIGNN route calculation results. Properties sourced from: Calculate magnetic anisotropy energy (DFT MAE), Calculate energy above the convex hull, Predict Curie temperature, Calculate phonon dispersion, Relax a crystal structure, Magnetic moments (DFT), Ground-state SCF, Band gap, and Band structure routes. ALIGNN predictions are excluded per requirement. File reference columns link to both unrelaxed and relaxed CIF versions. Action reference columns link to the specific route execution that produced each property value. Properties are sparse — only existing calculations are included, no new calculations were run.
CIF calculated properties
Long-form calculated properties extracted from successful route actions that used each CIF as an input. Columns fileid / actionid / route_id are Ouro references.