Skip to main content

Target, Evaluate, Improve: A self-improving loop for agentic systems

Project description

TEI Loop

Target, Evaluate, Improve — a self-improving loop for agentic systems.

Get Started

pip install tei-loop
python3 -m tei_loop your_agent.py

TEI does the rest:

  • Finds your agent function automatically
  • Generates a test query automatically
  • Evaluates across 4 dimensions
  • Applies targeted improvements
  • Saves results to tei-results/ folder (created next to your agent file)

If pip is not found, use pip3 instead.

What TEI Creates

your_project/
  your_agent.py
  tei-results/           <-- created automatically
    run_20260218_071500.json
    latest.json

Options

python3 -m tei_loop agent.py                             # Auto everything
python3 -m tei_loop agent.py --function my_func          # Pick specific function
python3 -m tei_loop agent.py --query "custom input"      # Custom test query
python3 -m tei_loop agent.py --retries 5                 # More improvement cycles
python3 -m tei_loop agent.py --verbose                   # Detailed output

Python API

import asyncio
from tei_loop import TEILoop

def my_agent(query: str) -> str:
    return result

async def main():
    loop = TEILoop(agent=my_agent)
    result = await loop.run("test query")
    print(result.summary())

asyncio.run(main())

4 Evaluation Dimensions

Dimension What it checks
Target Alignment Did the agent pursue the correct objective?
Reasoning Soundness Was the reasoning logical?
Execution Accuracy Were tools called correctly?
Output Integrity Is the output complete and accurate?

Two Modes

Runtime (default): Per-query improvement in seconds.

Development: Across many queries, permanent prompt improvements.

results = await loop.develop(queries=[...], max_iterations=50)

Works With Any Agent

Any Python callable. No framework lock-in: LangGraph, CrewAI, custom Python, FastAPI, anything.

License

MIT

Project details


Download files

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

Source Distribution

tei_loop-0.1.8.tar.gz (36.4 kB view details)

Uploaded Source

Built Distribution

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

tei_loop-0.1.8-py3-none-any.whl (47.3 kB view details)

Uploaded Python 3

File details

Details for the file tei_loop-0.1.8.tar.gz.

File metadata

  • Download URL: tei_loop-0.1.8.tar.gz
  • Upload date:
  • Size: 36.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for tei_loop-0.1.8.tar.gz
Algorithm Hash digest
SHA256 dd57f05eeb24ac796a0e2e6392289c4aa278052fc46ad3a6e9177c1f586da44a
MD5 46695a9e71fd2762401a38c6acd3bf0a
BLAKE2b-256 08d9b261502a506d5f2061d3d0365915600e99fbc70d430d3cbc9c659bcfa7ef

See more details on using hashes here.

File details

Details for the file tei_loop-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: tei_loop-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 47.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.9.6

File hashes

Hashes for tei_loop-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 e03978041b5a759c69d25f81bc5dbfa597857a6bbae10d5d53e1d82a7ef9552e
MD5 81fcc8edcf9e8ba7a009febfc9614f4d
BLAKE2b-256 5c19f279b955b14fba2fba52a7474b672f39d7ec83fa6a0dc5a27718024cb184

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page