Create Python SDK for HTTP transport

Open
#6 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
35/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
python
Domain
api, backend

Research direction

Start with examples/http-transport/client.py and docs/api-reference.md to understand the existing HTTP usage and API surface. Define the package boundaries and packaging approach before implementing the IrisClient methods, authentication, type hints, and async support. Done means iris-eval installs with pip, supports the listed operations, and is published to PyPI.

Written by the indexing model from the issue text.

Description

effort: large enhancement good first issue

Iris supports HTTP transport but there's no Python SDK. Python is the primary language for AI/ML development.

Goal: Create a lightweight Python package (iris-eval) that wraps the HTTP API.

Acceptance criteria:

  • pip install iris-eval
  • IrisClient class with methods: log_trace(), evaluate_output(), get_traces()
  • Authentication via API key
  • Type hints for all parameters
  • Async support (httpx)
  • Published to PyPI

Resources:

  • HTTP transport examples: examples/http-transport/client.py
  • API reference
Dominant language
TypeScript
Stars
9
Forks
4
Avg merge
2h 7m
Merged PRs (30d)
140

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from iris-eval/mcp-server

All issues in iris-eval/mcp-server

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.