Quickstart

Get started with GARUDA in 5 minutes. This guide covers authentication, your first query, and getting results in Parquet format.

1. Install the Client

Choose your language:

Rust

cargo add rakit-client

Python

pip install rakit-client

2. Authenticate

Get your API key from the GARUDA dashboard (free tier available).

Rust

use rakit_client::Client;

#[tokio::main]
async fn main() -> Result<()> {
    let client = Client::new("your-api-key-here");
    Ok(())
}

Python

from rakit_client import Client

client = Client(api_key="your-api-key-here")

3. Run Your First Query

Query average temperature by province for the last 30 days.

Rust

use rakit_client::Client;

#[tokio::main]
async fn main() -> Result<()> {
    let client = Client::new("your-api-key-here");

    let result = client
        .query(
            "SELECT province, AVG(temperature_c) as avg_temp
             FROM climate_observations
             WHERE timestamp > now() - interval '30 days'
             GROUP BY province
             ORDER BY avg_temp DESC"
        )
        .await?;

    println!("{:?}", result);
    Ok(())
}

Python

from rakit_client import Client

client = Client(api_key="your-api-key-here")

result = client.query("""
    SELECT province, AVG(temperature_c) as avg_temp
    FROM climate_observations
    WHERE timestamp > now() - interval '30 days'
    GROUP BY province
    ORDER BY avg_temp DESC
""")

print(result)

4. Get Results as Parquet

Results are returned as Apache Parquet by default—zero-copy, columnar format.

Rust

let result = client.query("...").await?;
result.to_parquet("output.parquet")?;

Python

result = client.query("...")
result.to_parquet("output.parquet")

5. Next Steps

• Available Datasets — Explore all available data domains
• API Reference — Full endpoint documentation
• Open Data — Download free Parquet datasets

Common Queries

Climate by Island

SELECT
    island,
    province,
    AVG(temperature_c) as avg_temp,
    AVG(precipitation_mm) as avg_precip
FROM climate_observations
WHERE timestamp > now() - interval '1 year'
GROUP BY island, province
ORDER BY avg_temp DESC;

Saka Calendar Enrichment

SELECT
    c.timestamp,
    c.temperature_c,
    s.saka_sasih,
    s.saka_pawukon
FROM climate_observations c
JOIN saka_calendar s ON DATE(c.timestamp) = s.gregorian_date
WHERE c.province = 'Bali'
LIMIT 100;

Troubleshooting

401 Unauthorized? Check your API key. Free tier keys are available at app.teknorakit.com.

Rate limited? Free tier: 100 requests/day. Upgrade to Developer plan for unlimited queries.

Need help? Email dev@teknorakit.com.