Skip to main content

RAGeval

CI License: MIT

PyPI License: MIT

Drop-in LLMOps observability. Self-hosted. SQLite-default. Persona-aware. Multi-judge consensus.

🔗 Live demo: https://rageval.ysiddo-ai-projects.app/demo/ · browser dashboard (score a query + view metrics). Also fully scriptable — API: /health, /eval/* via curl/HTTPie. On-demand backend (first request ~30–60 s to wake).

The 60-Second Pitch

from rageval import track

@track(model="anthropic/claude-sonnet-4-6", persona="cfo")
async def answer_question(query: str, context_chunks: list[str]) -> str:
    ...

That's it. Open the dashboard at localhost:8003.

What It Measures

Metric Definition
Retrieval relevance Cosine sim between query and retrieved chunks (BGE-large by default)
Groundedness consensus Multi-judge LLM scoring (Claude Haiku + Groq Llama + GPT-5-mini), flags disagreement
Faithfulness Per-sentence max-similarity to any chunk (NLI proxy)
Cost USD per interaction, tracked by model
Latency End-to-end wall-clock

Comparison vs Alternatives

Feature RAGeval Phoenix Langfuse TruLens
Self-hosted
SQLite default
Drop-in decorator partial partial
Persona-aware
Multi-judge consensus
Cost tracking partial
Setup time 60 sec 10 min 15 min 10 min

Quick Start

pip install omnismart-rageval     # distribution name; CLI + import remain `rageval`
rageval init                 # creates ~/.rageval/rageval.db
rageval serve --port 8003

Integration

FastAPI

from rageval import track

@app.post("/ask")
@track(model="anthropic/claude-sonnet-4-6", persona="cfo")
async def ask(query: str):
    chunks = await retriever.search(query)
    return await llm.generate(query, chunks=chunks)

LangChain

@track(model="groq/llama-3.3-70b-versatile")
def chain_invoke(query: str, context_chunks: list[str]):
    return chain.invoke({"query": query, "context": context_chunks})

Endpoints

Method Path Purpose
GET /health Liveness
POST /eval/log Score + store
POST /eval/score Score only (no storage)
GET /eval/metrics?days=7 Aggregate dashboard data
GET /eval/queries Query log (filter by needs_review)
GET /eval/cost-report?days=30 Cost breakdown by day + model
GET /eval/alerts Recent flagged queries
POST /eval/retrieval-bench A/B compare retrieval strategies
POST /eval/embedding-comparison Compare embedding models

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

omnismart_rageval-0.1.3.tar.gz (16.2 kB view details)

Uploaded Source

Built Distribution

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

omnismart_rageval-0.1.3-py3-none-any.whl (16.7 kB view details)

Uploaded Python 3

File details

Details for the file omnismart_rageval-0.1.3.tar.gz.

File metadata

  • Download URL: omnismart_rageval-0.1.3.tar.gz
  • Upload date:
  • Size: 16.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for omnismart_rageval-0.1.3.tar.gz
Algorithm Hash digest
SHA256 ee6928b77e12e253ee8d5e255f03f56d0dc9680e0c9a4ba6ef687a4fd25ecbec
MD5 aa20d2d0c560d2b9fa2e71844c14d5de
BLAKE2b-256 1c441668e9aceaefef50f8a7bcc6fc977a698735a7d504c7f9dc2774f5c51d54

See more details on using hashes here.

File details

Details for the file omnismart_rageval-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for omnismart_rageval-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 6f08a653abf3e7fba40f422b91af574778953ebac6d5f8016eb630e96eb4c4fe
MD5 21fbaeaec09d273a8d89d1033c7030dc
BLAKE2b-256 3f2ee10b5b24b5b7fea2eda8cd017131d72d49a20902c955074ce65a66f7e9cc

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 Sentry Error logging StatusPage Status page