This release is a pre-release and may not be stable for production use.
!! IMPORTANT: Starting from 1.3.3 there will be some breaking changes due to regulatory changes by EPDK. Overhaul is planned to finish with the next mid release 1.4.0
!! CRITICAL: Due to authentication method changes you are strongly recommended to update the eptr2 version to 1.2.4+
Note: From 1.3.0 and onwards, eptr2 starts to evolve to be an AI oriented tool. You can use it as an MCP server, directly use them in your LLMs and AI agents to write your code for you.
eptr2
eptr2 (EPIAS Transparency 2.0) is a Python client for the EPIAS Transparency Platform v2.0 API, covering 231 services of the Turkish electricity and natural gas markets. It is an unofficial package by Robokami / Tideseed with Apache License 2.0.
📖 Full documentation: https://tideseed.github.io/eptr2/
- Live demo: https://eptr2demo.streamlit.app/ (or run
eptr2demolocally after installing)
Installation
Recommended (includes pandas, MCP server support and other extras):
pip install "eptr2[allextras]"
Minimal install (thin client only): pip install eptr2. Both work with uv pip install as well.
Quickstart
Register with the EPIAS Transparency Platform, then:
from eptr2 import EPTR2
eptr = EPTR2(username="YOUR_USERNAME", password="YOUR_PASSWORD")
res = eptr.call("mcp", start_date="2024-07-29", end_date="2024-07-29")
Or keep credentials in a .env file (EPTR_USERNAME=... / EPTR_PASSWORD=...) and reuse authentication tickets:
eptr = EPTR2(use_dotenv=True, recycle_tgt=True)
df = eptr.call("mcp", start_date="2025-08-01", end_date="2025-08-31")
All 231 services follow the same pattern — discover them with eptr.get_available_calls() or eptr2 search <keyword> from the shell. See the docs for installation, authentication and basic usage.
AI Agents & Tooling
eptr2 ships provider-agnostic tooling for AI assistants and agents:
- CLI —
eptr2 list / search / describe / callfor shell-driven agents (data on stdout, JSON or CSV) - MCP server — 17 tools for any Model Context Protocol client (
eptr2-mcp-server) - Agent skills — 7 bundled skills in the open Agent Skills (SKILL.md) format:
eptr2 install-skills - Agent Plugin — skills + MCP server packaged in the portable agent-plugins.org format:
eptr2 plugin-path - Machine-readable schema — all 231 endpoints with parameters, auto-generated:
eptr2 schema --stdout
pip install "eptr2[allextras]"
eptr2 describe mcp # discover (no credentials)
eptr2 call mcp --start-date 2024-07-29 --end-date 2024-07-29 --format csv
eptr2 mcp-config --client vscode # MCP config for your client
See AGENTS.md and the AI integration docs: MCP server · MCP client setup · agent skills · Agent Plugin · CLI.
Teaching an agent this library: point it at AGENTS.md (many tools, including VS Code and Claude Code, read it automatically in this repo). Outside the repo, eptr2 schema --stdout emits a machine-readable description of every endpoint, and eptr2 describe <key> / eptr2 search <keyword> answer parameter questions without credentials — AGENTS.md has the full learning path.
Going Further
| Topic | Documentation |
|---|---|
| All 231 API calls, categories and parameters | Available API Calls |
Typed get_* wrapper functions (eptr2.calls) |
Convenience Wrappers |
| Aliases, bulk calls, DataFrames | Basic Usage · DataFrames |
| Composite functions (consumption, prices/costs, production, IDM, BPM, plant costs) | Composite Functions |
| Imbalance / KÜPST cost calculations | Utilities API |
| Streamlit demo and calculator tutorials | Tutorials |
| Turkish market abbreviations (PTF, SMF, KGÜP, ...) | Abbreviations |
| Release history | Changelog |
About
🇬🇧 eptr2 is a thin wrapper around the EPIAS Transparency Platform v2.0 API. Free and permissible use for commercial applications with Apache License 2.0 (details).
🇹🇷 eptr2, Robokami tarafından EPİAŞ Şeffaflık Platformu 2.0 API'si üzerine geliştirilmiş bir Python paketidir. Apache License 2.0 ile lisanslanmıştır; 231 veri servisine erişim sağlar. Detaylı dokümantasyon: https://tideseed.github.io/eptr2/
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file eptr2-1.3.9.dev2.tar.gz.
File metadata
- Download URL: eptr2-1.3.9.dev2.tar.gz
- Upload date:
- Size: 197.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b6667b334a1fa6662eb0d00b57af7610291931e9b2344d63f8f11796980de1a0
|
|
| MD5 |
708d576b09fbf2c726e4397111227770
|
|
| BLAKE2b-256 |
2ef6407a724c46921bb8e63eb735d41c783371d7ef3106ea93c240f5e8a07a5e
|
File details
Details for the file eptr2-1.3.9.dev2-py3-none-any.whl.
File metadata
- Download URL: eptr2-1.3.9.dev2-py3-none-any.whl
- Upload date:
- Size: 225.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fc8ae3220b2b5a5a094c68bffa18fd1dcb0810e628d8179df8907c8ac86e2dc2
|
|
| MD5 |
4bb1a9f68e12a35fe1273348d6fb1fdd
|
|
| BLAKE2b-256 |
872c986c5891e36901bfdac7c3544e95ce417692d787a523f757ccf3f3d108ed
|
