AI Transform

AI-powered data transformations between JSON-serializable types using OpenAI.

Quick Start

[dependencies]
ai-transform = "0.1.0"
ai-transform-runtime = "0.1.0"  # Required
serde = { version = "1.0.219", features = ["derive"] }
tokio = { version = "1.45.1", features = ["full"] }

use ai_transform::transform;
use serde::{Deserialize, Serialize};

#[derive(Serialize, Deserialize, Default)]
struct User { name: String, age: u32 }

#[derive(Serialize, Deserialize, Default)]
struct Profile { full_name: String, years_old: u32, is_adult: bool }

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    std::env::set_var("OPENAI_API_KEY", "your-api-key");

    let user = User { name: "Alice".to_string(), age: 28 };
    let profile: Profile = transform!(User, Profile, user).await?;
    // AI maps: name → full_name, age → years_old, computes is_adult

    Ok(())
}

⚠️ Important: Type Compatibility

Only use this macro when you are confident the transformation makes semantic sense.

The AI will attempt to map between your types, but you must make sure the mapping is logically sound and meaningful within your context.

Good use cases:

struct ApiResponse { user_id: String, first_name: String, last_name: String }
struct InternalUser { id: String, full_name: String }
// Clear semantic relationship

Requirements

Dependencies:

ai-transform - The macro
ai-transform-runtime - Runtime (called by generated code)

Environment: OPENAI_API_KEY="your-key"

Types: Must implement Serialize + Deserialize + Default

How It Works

Macro generates call to runtime
Serializes source value to JSON
Creates example schemas using Default
Sends AI transformation prompt
Deserializes response to target type

Examples

See examples/ for usage examples.

Considerations

Makes HTTP request to OpenAI per transformation
Costs based on OpenAI pricing

Configuration

OPENAI_API_KEY: Required
OPENAI_MODEL: Default "gpt-4o"
OPENAI_BASE_URL: Default OpenAI endpoint

Testing

cargo test                                    # Unit tests
OPENAI_API_KEY="key" cargo test -- --ignored # Integration tests

License

MIT

ai-transform 0.1.0