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.
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 = "01cfff7b-2489-42b4-89fd-40190cad95fa"
# Retrieve file metadata
file = ouro.files.retrieve(file_id)
print(file.name, file.visibility)
print(file.metadata)Get a URL to download or embed the file. For private assets, the URL is temporary and will expire after 1 hour.
# 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 (name, description, visibility, etc.) and optionally replace the file data with a new file. Requires write or admin permission.
# 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"
)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)RE-free PM lab shortlist
Single working shortlist of 250 RE-free permanent-magnet candidates ranked deterministically for laboratory triage. Requires a CIF and calculated saturation magnetization; MAE, Curie temperature, and hull distance are retained when available and missing evidence is explicitly penalized via . Score weights: magnetic 0.40, synthesizability 0.30, supply concentration (HHI) 0.15, toxicity 0.15. CIF and source-dataset references are native links. Generated by rank-re-free-magnets v5; config fingerprint 319914cfce92.
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.