ai

ez-ai — AI Standard Library for EZ

Call OpenAI, Anthropic, and Gemini from your EZ scripts with one line.

Installation

ez install ai

Or manually copy the ai/ folder into C:/ezlib/.

Quick Start

use "ai"

# One-liner (auto-detects provider from API key)
response = ask("What is the capital of France?", "sk-YOUR-OPENAI-KEY")
out response

API Reference

ask(prompt, apiKey) → String

Auto-detects provider from key prefix:

• sk-... → OpenAI
• AIza... → Gemini
• Other → Anthropic

ask_with_system(prompt, apiKey, systemPrompt) → String

Same as ask() but with a system prompt.

OpenAI

response = openai("Hello!", apiKey)
response = openai_model("Hello!", apiKey, "gpt-4o")
response = openai_full("Hello!", apiKey, "gpt-4o", "You are helpful")

Anthropic

response = anthropic("Hello!", apiKey)
response = anthropic_model("Hello!", apiKey, "claude-3-haiku-20240307")
response = anthropic_full("Hello!", apiKey, "claude-3-5-sonnet-20241022", "Be concise")

Gemini

response = gemini("Hello!", apiKey)
response = gemini_model("Hello!", apiKey, "gemini-1.5-pro")
response = gemini_full("Hello!", apiKey, "gemini-1.5-flash", "Be brief")

Chat Sessions (Multi-Turn)

use "ai"

# Create a chat
chat = new_chat("openai", apiKey)

# Or with a system prompt
chat = new_chat_with_system("openai", apiKey, "You are a pirate")

# Send messages (history is tracked automatically)
r1 = chat_send(chat, "Hello!")
out r1

r2 = chat_send(chat, "Tell me more")
out r2

# Change model mid-conversation
chat = chat_set_model(chat, "gpt-4o")

Error Handling

All tasks return nil on failure and print an error message prefixed with [ez-ai]. Wrap calls in try/catch for safety:

try {
    response = ask("Hello", apiKey)
    when response != nil {
        out response
    }
} catch e {
    out "Something went wrong: " + str(e)
}

License

MIT