idun-sdk

A thin, dependency-free Python client + CLI for Azure AI Foundry agents (Idun / NatureLM) and any OpenAI-compatible endpoint. Tenant-agnostic by design: bring your own Foundry resource — no hardcoded tenant coordinates.

Install

pip install idun-sdk
# with optional PDF ingest:
pip install "idun-sdk[pdf]"   # pulls PyPDF2

Quick start (SDK)

from idun import IdunClient

client = IdunClient()                 # reads ~/.idun/config.toml
out = client.complete("Summarize the quarterly risk report.")
print(out["text"])

Two CLIs — two separate setup wizards (intentionally, not one)

This package ships two command-line tools with distinct purposes. They are intentionally kept separate — idun is the Azure AI Foundry client, idun-multi is the multi-provider LLM console. There is no unified idun-wizard; each tool has its own first-run setup wizard:

idun — the Azure AI Foundry client. Agent completions, trajectory export, document matrix (idun matrix), prompt packs (idun run / idun packs), and Hugging Face Hub operations (idun hf). Azure-specific.
- idun wizard configures the Azure Foundry client (endpoint / project / agent) in ~/.idun/config.toml.
idun-multi — the multi-provider LLM console. Talks to any of the 17 registered providers (OpenAI, Anthropic, Groq, OpenRouter, HF, …) plus race, cost, models, doctor, support. Provider-agnostic.
- idun-multi wizard configures the default LLM provider (picks one of the 17 registered providers and prints the provider table so you can choose) in ~/.idun/config.toml.

Both wizards write only to ~/.idun/config.toml (never ~/.idunrc, which is no longer used). Credentials live in per-provider ~/.idun/<id>.token files (0600).

idun-multi providers        # list providers + credential status
idun-multi -p openrouter ask "hello"   # -p goes BEFORE the subcommand
idun-multi race "explain quantum"      # compare providers on one prompt
idun-multi doctor            # environment + credential audit (also checks scripts)
idun-multi wizard            # pick the default LLM provider
idun wizard                  # configure the Azure Foundry client

Async

import asyncio
from idun import AsyncIdunClient

async def main():
    c = AsyncIdunClient()
    out = await c.acomplete("What changed vs last quarter?")
    print(out["text"])

asyncio.run(main())

CLI

idun — Azure AI Foundry client:

idun chat "your prompt"        # one-shot completion
idun trace "your prompt"       # full agent trajectory (steps)
idun export "your prompt" -o trace.md   # run + save trajectory (json/md)
idun token                     # inspect / rotate stored Entra token
idun login                     # device-code login to your Foundry (azure/hf/openai)
idun status                    # show resolved backend + credential state
idun run <pack> <key>          # run a bundled prompt pack
idun packs                     # list bundled prompt packs
idun matrix  --docs DIR --questions FILE   # Doc x Question pivot (IDEA α)
idun diff-docs --doc-a A --doc-b B --topics T  # clause-drift compare (IDEA γ)
idun diff "A" "B"              # compare two prompt trajectories side-by-side
idun hf whoami|status|push     # Hugging Face Hub operations
idun openapi                   # print the bundled OpenAPI 3 spec for the completion API
idun logo                      # show bundled Foundry logo paths
idun welcome                   # ASCII banner
idun wizard                    # configure the Azure Foundry client

idun-multi — multi-provider LLM console (-p <provider> goes BEFORE the subcommand):

idun-multi providers          # list providers + credential status
idun-multi -p openrouter ask "hello"   # chat with a provider
idun-multi race "explain quantum"      # compare providers on one prompt
idun-multi models              # list models (or --discover)
idun-multi cost                # token / cost estimate
idun-multi doctor              # environment + credential audit
idun-multi wizard              # pick the default LLM provider

Supported providers

The idun CLI / IdunClient speak to any OpenAI-compatible endpoint plus the native Azure AI Foundry transport. Registered providers (4 groups):

OpenAI-compatible: openai, groq, together, perplexity, fireworks, novita, xai, deepseek, mistral, openrouter, gemini, hf, nous
Anthropic: anthropic (Claude)
Azure: azure (Azure AI Foundry / Idun agent)
Local: ollama, local (bring your own endpoint)

Each provider's capabilities (streaming, tools, vision, JSON mode) are derived from the transports actually implemented in idun/providers.py — see SUPPORT_MATRIX.md for the full, code-generated matrix and per-transport capability details.

Hugging Face (hf): uses the OpenAI-compatible router https://router.huggingface.co/v1 (the legacy api-inference.huggingface.co host was retired). Requires an HF token (HF_TOKEN).

Any OpenAI-compatible base URL works with zero code changes — set it in the config and the provider switches automatically.

Configuration (tenant-agnostic)

~/.idun/config.toml (neutral defaults — supply your own resource). Secrets go to per-provider ~/.idun/<id>.token files (mode 0600), not in this file:

# Written by `idun-multi wizard` (LLM provider default):
[defaults]
provider = "openrouter"

[openrouter]
model = "deepseek/deepseek-chat"

# Written by `idun wizard` (Azure AI Foundry client):
[azure]
base   = "https://YOUR-RESOURCE.services.ai.azure.com"
agent  = "your-agent-name"
project = "your-project"

No tenant coordinates are baked into the shipped code. The CLI reads the config via idun.config; environment variables (IDUN_PROVIDER, OPENAI_API_KEY, …) always win over the file.

Additional features

These build on the core SDK and live in idun.matrix / the playground repo.

Idun Matrix — Doc × Question pivot (IDEA α)

Build an N × M answer matrix over documents × questions. Each cell carries the answer, the source citation, and a status (GREEN = answered+cited, RED = contradiction, GRAY = no info).

idun matrix --docs ./contracts --questions ./questions.txt

Clause Drift compare (IDEA γ)

Compare two documents across topics and flag deviations:

idun diff-docs --doc-a contract_a.txt --doc-b contract_b.txt --topics topics.txt

PocketPal-style Bridge (IDEA β)

A tenant-agnostic mobile web UI that runs idun matrix against your Foundry resource: https://qapdex-maker.github.io/idun-playground/matrix_app.html

Development

pip install -e ".[dev]"
pytest        # offline; no network/API keys required
ruff check .  # lint (pinned ruff==0.15.10 in CI)

License

MIT.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

idun_sdk-1.0.28.tar.gz (129.5 kB view details)

Uploaded Aug 22, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

idun_sdk-1.0.28-py3-none-any.whl (91.9 kB view details)

Uploaded Aug 22, 2026 Python 3

File details

Details for the file idun_sdk-1.0.28.tar.gz.

File metadata

Download URL: idun_sdk-1.0.28.tar.gz
Upload date: Aug 22, 2026
Size: 129.5 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for idun_sdk-1.0.28.tar.gz
Algorithm	Hash digest
SHA256	`efe505ea7211234fd006be15d6f2cbee122eebbfcfce3569cd7c0bfe6229335b`
MD5	`89ef9c2c663d1f6d9015972b6fd4d93d`
BLAKE2b-256	`1f5851a70998480cef4401b5a980dc60148ec5d376788e7d9c8a7d762c6d8aed`

See more details on using hashes here.

File details

Details for the file idun_sdk-1.0.28-py3-none-any.whl.

File metadata

Download URL: idun_sdk-1.0.28-py3-none-any.whl
Upload date: Aug 22, 2026
Size: 91.9 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for idun_sdk-1.0.28-py3-none-any.whl
Algorithm	Hash digest
SHA256	`546bdb0673b33a02702b04b7f32a04b7796fc9998f40dec5313799f9091adc68`
MD5	`d643bee29e7d8e668e33d367fa3f5ee6`
BLAKE2b-256	`67f185c030ec9c9f75bd0feffeafa8cb70b21e6fd7a0ea657fc2ea8df775b808`