llmapi-tracker 1.0.0__tar.gz → 1.0.2__tar.gz

{llmapi_tracker-1.0.0/llmapi_tracker.egg-info → llmapi_tracker-1.0.2}/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: llmapi-tracker
-Version: 1.0.0
+Version: 1.0.2
 Summary: Local-first API usage and cost tracking platform
 Author: API Tracker
 License: MIT
+Project-URL: Homepage, https://github.com/Lns9777/API-Usage-Tracker
+Project-URL: Repository, https://github.com/Lns9777/API-Usage-Tracker
+Project-URL: Issues, https://github.com/Lns9777/API-Usage-Tracker/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -27,24 +30,24 @@ Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: twine>=5.1; extra == "dev"
 Dynamic: license-file
 
-# API Tracker
+# llmapi-tracker
 
 ## What API Tracker Is
 
-API Tracker is a local-first API usage and cost observability tool. It records request volume, token usage, latency, status, and versioned pricing for models from providers such as OpenAI and Gemini.
+`llmapi-tracker` is a local-first API usage and cost observability platform for LLM applications. It records request counts, token usage, latency, errors, and versioned pricing for provider models such as OpenAI and Gemini.
 
-The project is built to keep data local by default. It stores usage and pricing in a local SQLite database and does not persist prompts, responses, or raw API keys in the application database.
+The project is designed to keep data local by default. It stores usage and pricing in a local SQLite database and does not persist prompts, responses, or raw API keys in the application database.
 
 ## Features
 
 - Local FastAPI backend with SQLite storage
 - Versioned pricing records for historical cost tracking
 - Usage capture for input, output, thinking, cached, and total tokens
-- Cost calculation per request and across analytics views
+- Request-level and analytics-level cost calculation
 - React + Vite dashboard for usage, analytics, providers, models, and pricing
 - SDK wrappers for OpenAI and Gemini
 - Packaged launcher command that starts the local app and opens the browser
-- Open-source repository setup with tests, CI, and release automation
+- Open-source repository with tests, CI, and release automation
 
 ## Installation
 
@@ -65,10 +68,16 @@ npm install
 
 ### Package install
 
-If you install this project as a package, the launcher command is:
+```bash
+pip install llmapi-tracker
+```
+
+If you want optional provider SDK support:
 
 ```bash
-api-tracker
+pip install "llmapi-tracker[openai]"
+pip install "llmapi-tracker[gemini]"
+pip install "llmapi-tracker[all]"
 ```
 
 ## Starting the Application
@@ -88,7 +97,7 @@ npm run dev
 
 ### Packaged app
 
-After building the frontend assets and packaging them into the backend static directory, run:
+After the frontend assets are built and packaged into the backend static directory:
 
 ```bash
 api-tracker
@@ -102,7 +111,7 @@ The launcher starts the backend server and opens the browser to the local dashbo
 
 ```python
 import os
-from sdk.api_tracker import APITracker
+from api_tracker import APITracker
 
 tracker = APITracker(
     project="Pharmacy-AI",
@@ -201,7 +210,7 @@ python scripts/verify_frontend_assets.py
 
 ## Contributing
 
-This repository is intended to be open source and contributor friendly.
+`llmapi-tracker` is intended to be open source and contributor friendly.
 
 Contribution files:
 
@@ -221,5 +230,5 @@ Contribution expectations:
 
 ## License
 
-API Tracker is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
+`llmapi-tracker` is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
 

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/README.md

@@ -1,21 +1,21 @@
-# API Tracker
+# llmapi-tracker
 
 ## What API Tracker Is
 
-API Tracker is a local-first API usage and cost observability tool. It records request volume, token usage, latency, status, and versioned pricing for models from providers such as OpenAI and Gemini.
+`llmapi-tracker` is a local-first API usage and cost observability platform for LLM applications. It records request counts, token usage, latency, errors, and versioned pricing for provider models such as OpenAI and Gemini.
 
-The project is built to keep data local by default. It stores usage and pricing in a local SQLite database and does not persist prompts, responses, or raw API keys in the application database.
+The project is designed to keep data local by default. It stores usage and pricing in a local SQLite database and does not persist prompts, responses, or raw API keys in the application database.
 
 ## Features
 
 - Local FastAPI backend with SQLite storage
 - Versioned pricing records for historical cost tracking
 - Usage capture for input, output, thinking, cached, and total tokens
-- Cost calculation per request and across analytics views
+- Request-level and analytics-level cost calculation
 - React + Vite dashboard for usage, analytics, providers, models, and pricing
 - SDK wrappers for OpenAI and Gemini
 - Packaged launcher command that starts the local app and opens the browser
-- Open-source repository setup with tests, CI, and release automation
+- Open-source repository with tests, CI, and release automation
 
 ## Installation
 
@@ -36,10 +36,16 @@ npm install
 
 ### Package install
 
-If you install this project as a package, the launcher command is:
+```bash
+pip install llmapi-tracker
+```
+
+If you want optional provider SDK support:
 
 ```bash
-api-tracker
+pip install "llmapi-tracker[openai]"
+pip install "llmapi-tracker[gemini]"
+pip install "llmapi-tracker[all]"
 ```
 
 ## Starting the Application
@@ -59,7 +65,7 @@ npm run dev
 
 ### Packaged app
 
-After building the frontend assets and packaging them into the backend static directory, run:
+After the frontend assets are built and packaged into the backend static directory:
 
 ```bash
 api-tracker
@@ -73,7 +79,7 @@ The launcher starts the backend server and opens the browser to the local dashbo
 
 ```python
 import os
-from sdk.api_tracker import APITracker
+from api_tracker import APITracker
 
 tracker = APITracker(
     project="Pharmacy-AI",
@@ -172,7 +178,7 @@ python scripts/verify_frontend_assets.py
 
 ## Contributing
 
-This repository is intended to be open source and contributor friendly.
+`llmapi-tracker` is intended to be open source and contributor friendly.
 
 Contribution files:
 
@@ -192,5 +198,5 @@ Contribution expectations:
 
 ## License
 
-API Tracker is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
+`llmapi-tracker` is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
 

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/database.py

@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-import os
-
 from sqlalchemy import create_engine
 from sqlalchemy.orm import declarative_base, sessionmaker
 

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/frontend.py

@@ -1,7 +1,5 @@
 from __future__ import annotations
 
-from pathlib import Path
-
 from fastapi import APIRouter
 from fastapi.responses import FileResponse
 from fastapi.staticfiles import StaticFiles
@@ -12,7 +10,11 @@ from .paths import get_frontend_dist_dir
 def mount_frontend(app, prefix: str = "") -> None:
     static_dir = get_frontend_dist_dir()
     if static_dir.exists():
-        app.mount(prefix or "/assets", StaticFiles(directory=static_dir / "assets"), name="assets")
+        app.mount(
+            prefix or "/assets",
+            StaticFiles(directory=static_dir / "assets"),
+            name="assets",
+        )
 
 
 def register_frontend_routes(router: APIRouter) -> None:

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/launcher.py

@@ -10,7 +10,11 @@ import uvicorn
 def launch_app() -> None:
     host = os.getenv("API_TRACKER_HOST", "127.0.0.1")
     port = int(os.getenv("API_TRACKER_PORT", "8000"))
-    open_browser = os.getenv("API_TRACKER_OPEN_BROWSER", "true").lower() not in {"0", "false", "no"}
+    open_browser = os.getenv("API_TRACKER_OPEN_BROWSER", "true").lower() not in {
+        "0",
+        "false",
+        "no",
+    }
     if open_browser:
         url = f"http://{host}:{port}"
         threading.Timer(1.0, lambda: webbrowser.open(url)).start()

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/main.py

@@ -1,5 +1,3 @@
-from pathlib import Path
-
 from fastapi import FastAPI
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.responses import FileResponse

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/models.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from datetime import datetime
+from datetime import datetime, timezone
 
 from sqlalchemy import (
     JSON,
@@ -20,7 +20,8 @@ from .database import Base
 
 
 def utcnow() -> datetime:
-    return datetime.utcnow()
+    # return datetime.utcnow()
+    return datetime.now(timezone.utc)
 
 
 class Project(Base):
@@ -42,21 +43,29 @@ class Provider(Base):
     name = Column(String(100), unique=True, nullable=False, index=True)
     created_at = Column(DateTime, default=utcnow, nullable=False)
 
-    models = relationship("Model", back_populates="provider", cascade="all, delete-orphan")
+    models = relationship(
+        "Model", back_populates="provider", cascade="all, delete-orphan"
+    )
 
 
 class Model(Base):
     __tablename__ = "models"
-    __table_args__ = (UniqueConstraint("provider_id", "model_name", name="uq_provider_model_name"),)
+    __table_args__ = (
+        UniqueConstraint("provider_id", "model_name", name="uq_provider_model_name"),
+    )
 
     id = Column(Integer, primary_key=True, index=True)
-    provider_id = Column(Integer, ForeignKey("providers.id"), nullable=False, index=True)
+    provider_id = Column(
+        Integer, ForeignKey("providers.id"), nullable=False, index=True
+    )
     model_name = Column(String(150), nullable=False, index=True)
     model_type = Column(String(50), default="text", nullable=False)
     created_at = Column(DateTime, default=utcnow, nullable=False)
 
     provider = relationship("Provider", back_populates="models")
-    pricing = relationship("ModelPricing", back_populates="model", cascade="all, delete-orphan")
+    pricing = relationship(
+        "ModelPricing", back_populates="model", cascade="all, delete-orphan"
+    )
     usage = relationship("ApiUsage", back_populates="model_ref")
 
 
@@ -86,7 +95,9 @@ class ApiUsage(Base):
 
     id = Column(Integer, primary_key=True, index=True)
     project_id = Column(Integer, ForeignKey("projects.id"), nullable=False, index=True)
-    provider_id = Column(Integer, ForeignKey("providers.id"), nullable=False, index=True)
+    provider_id = Column(
+        Integer, ForeignKey("providers.id"), nullable=False, index=True
+    )
     model_id = Column(Integer, ForeignKey("models.id"), nullable=False, index=True)
     internal_request_id = Column(String(255), nullable=False, unique=True, index=True)
     provider_request_id = Column(String(255), nullable=True, index=True)

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/paths.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 import os
 from pathlib import Path
 
-
 APP_NAME = "API Tracker"
 
 

llmapi_tracker-1.0.2/backend/app/routes/analytics.py

@@ -0,0 +1,171 @@
+from fastapi import APIRouter, Depends
+from sqlalchemy import func
+from sqlalchemy.orm import Session
+
+from ..database import get_db
+from ..models import ApiUsage, Model, Project, Provider
+
+router = APIRouter(prefix="/analytics", tags=["Analytics"])
+
+
+@router.get("/overview")
+def overview(db: Session = Depends(get_db)):
+    rows = db.query(ApiUsage).all()
+    count = len(rows)
+    total_tokens = sum(r.total_tokens for r in rows)
+    total_cost = sum(r.total_cost for r in rows)
+    avg_latency = (sum(r.latency_ms for r in rows) / count) if count else 0
+    error_rate = (
+        ((sum(1 for r in rows if r.status != "success") / count) * 100) if count else 0
+    )
+    return {
+        "requests": count,
+        "tokens": total_tokens,
+        "cost": total_cost,
+        "average_latency_ms": avg_latency,
+        "error_rate": error_rate,
+    }
+
+
+@router.get("/cost")
+def cost(db: Session = Depends(get_db)):
+    rows = (
+        db.query(
+            func.date(ApiUsage.timestamp).label("day"), func.sum(ApiUsage.total_cost)
+        )
+        .group_by("day")
+        .all()
+    )
+    return [{"date": str(day), "cost": cost or 0} for day, cost in rows]
+
+
+@router.get("/tokens")
+def tokens(db: Session = Depends(get_db)):
+    rows = (
+        db.query(
+            func.date(ApiUsage.timestamp).label("day"),
+            func.sum(ApiUsage.input_tokens),
+            func.sum(ApiUsage.output_tokens),
+            func.sum(ApiUsage.thinking_tokens),
+            func.sum(ApiUsage.cached_tokens),
+        )
+        .group_by("day")
+        .all()
+    )
+    return [
+        {
+            "date": str(day),
+            "input": i or 0,
+            "output": o or 0,
+            "thinking": t or 0,
+            "cached": c or 0,
+        }
+        for day, i, o, t, c in rows
+    ]
+
+
+@router.get("/latency")
+def latency(db: Session = Depends(get_db)):
+    rows = [row.latency_ms for row in db.query(ApiUsage).all()]
+    if not rows:
+        return {"average": 0, "p50": 0, "p95": 0, "p99": 0}
+    rows.sort()
+    count = len(rows)
+    return {
+        "average": sum(rows) / count,
+        "p50": rows[int(count * 0.5) - 1 if count > 1 else 0],
+        "p95": rows[int(count * 0.95) - 1 if count > 1 else 0],
+        "p99": rows[int(count * 0.99) - 1 if count > 1 else 0],
+    }
+
+
+@router.get("/errors")
+def errors(db: Session = Depends(get_db)):
+    rows = (
+        db.query(ApiUsage.error_type, func.count(ApiUsage.id))
+        .filter(ApiUsage.status != "success")
+        .group_by(ApiUsage.error_type)
+        .all()
+    )
+    return [
+        {"error_type": error_type or "Unknown", "count": count}
+        for error_type, count in rows
+    ]
+
+
+@router.get("/by-project")
+def by_project(db: Session = Depends(get_db)):
+    rows = (
+        db.query(
+            Project.name,
+            func.count(ApiUsage.id),
+            func.sum(ApiUsage.total_tokens),
+            func.sum(ApiUsage.total_cost),
+            func.avg(ApiUsage.latency_ms),
+        )
+        .join(ApiUsage, ApiUsage.project_id == Project.id)
+        .group_by(Project.name)
+        .all()
+    )
+    return [
+        {
+            "project": name,
+            "requests": req or 0,
+            "tokens": tokens or 0,
+            "cost": cost or 0,
+            "latency_ms": latency or 0,
+        }
+        for name, req, tokens, cost, latency in rows
+    ]
+
+
+@router.get("/by-provider")
+def by_provider(db: Session = Depends(get_db)):
+    rows = (
+        db.query(
+            Provider.name,
+            func.count(ApiUsage.id),
+            func.sum(ApiUsage.total_tokens),
+            func.sum(ApiUsage.total_cost),
+            func.avg(ApiUsage.latency_ms),
+        )
+        .join(ApiUsage, ApiUsage.provider_id == Provider.id)
+        .group_by(Provider.name)
+        .all()
+    )
+    return [
+        {
+            "provider": name,
+            "requests": req or 0,
+            "tokens": tokens or 0,
+            "cost": cost or 0,
+            "latency_ms": latency or 0,
+        }
+        for name, req, tokens, cost, latency in rows
+    ]
+
+
+@router.get("/by-model")
+def by_model(db: Session = Depends(get_db)):
+    rows = (
+        db.query(
+            Model.model_name,
+            func.count(ApiUsage.id),
+            func.sum(ApiUsage.total_tokens),
+            func.sum(ApiUsage.total_cost),
+            func.avg(ApiUsage.latency_ms),
+        )
+        .join(ApiUsage, ApiUsage.model_id == Model.id)
+        .group_by(Model.model_name)
+        .all()
+    )
+    return [
+        {
+            "model": name,
+            "requests": req or 0,
+            "tokens": tokens or 0,
+            "cost": cost or 0,
+            "latency_ms": latency or 0,
+        }
+        for name, req, tokens, cost, latency in rows
+    ]

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/routes/models.py

@@ -17,7 +17,10 @@ def list_models(db: Session = Depends(get_db)):
 def create_model(payload: ModelCreate, db: Session = Depends(get_db)):
     row = (
         db.query(Model)
-        .filter(Model.provider_id == payload.provider_id, Model.model_name == payload.model_name)
+        .filter(
+            Model.provider_id == payload.provider_id,
+            Model.model_name == payload.model_name,
+        )
         .first()
     )
     if row:

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/routes/pricing.py

@@ -23,7 +23,9 @@ def list_pricing(db: Session = Depends(get_db)):
 
 
 @router.put("/{pricing_id}", response_model=PricingResponse)
-def update_pricing(pricing_id: int, pricing: PricingUpdate, db: Session = Depends(get_db)):
+def update_pricing(
+    pricing_id: int, pricing: PricingUpdate, db: Session = Depends(get_db)
+):
     row = db.query(ModelPricing).filter(ModelPricing.id == pricing_id).first()
     if not row:
         raise HTTPException(status_code=404, detail="Pricing not found")

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/routes/projects.py

@@ -34,7 +34,9 @@ def get_project(project_id: int, db: Session = Depends(get_db)):
 
 
 @router.put("/{project_id}", response_model=ProjectResponse)
-def update_project(project_id: int, project: ProjectUpdate, db: Session = Depends(get_db)):
+def update_project(
+    project_id: int, project: ProjectUpdate, db: Session = Depends(get_db)
+):
     row = db.query(Project).filter(Project.id == project_id).first()
     if not row:
         raise HTTPException(status_code=404, detail="Project not found")

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/routes/usage.py

@@ -2,7 +2,7 @@ from fastapi import APIRouter, Depends, HTTPException
 from sqlalchemy.orm import Session
 
 from ..database import get_db
-from ..models import ApiUsage, Model, Project, Provider
+from ..models import ApiUsage
 from ..schemas import UsageDataIn, UsageResponse
 from ..services.usage_service import create_usage
 

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/schemas.py

@@ -1,14 +1,14 @@
 from __future__ import annotations
 
 from datetime import datetime
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict, Field
 
 
 class ProjectBase(BaseModel):
     name: str
-    description: Optional[str] = None
+    description: str | None = None
     environment: str = "development"
 
 
@@ -17,9 +17,9 @@ class ProjectCreate(ProjectBase):
 
 
 class ProjectUpdate(BaseModel):
-    name: Optional[str] = None
-    description: Optional[str] = None
-    environment: Optional[str] = None
+    name: str | None = None
+    description: str | None = None
+    environment: str | None = None
 
 
 class ProjectResponse(ProjectBase):
@@ -58,17 +58,17 @@ class PricingCreate(BaseModel):
     cached_input_price_per_1m: float = 0.0
     currency: str = "USD"
     effective_from: datetime
-    effective_to: Optional[datetime] = None
+    effective_to: datetime | None = None
 
 
 class PricingUpdate(BaseModel):
-    input_price_per_1m: Optional[float] = None
-    output_price_per_1m: Optional[float] = None
-    thinking_price_per_1m: Optional[float] = None
-    cached_input_price_per_1m: Optional[float] = None
-    currency: Optional[str] = None
-    effective_from: Optional[datetime] = None
-    effective_to: Optional[datetime] = None
+    input_price_per_1m: float | None = None
+    output_price_per_1m: float | None = None
+    thinking_price_per_1m: float | None = None
+    cached_input_price_per_1m: float | None = None
+    currency: str | None = None
+    effective_from: datetime | None = None
+    effective_to: datetime | None = None
 
 
 class PricingResponse(PricingCreate):
@@ -83,7 +83,7 @@ class UsageDataIn(BaseModel):
     provider: str
     model: str
     internal_request_id: str
-    provider_request_id: Optional[str] = None
+    provider_request_id: str | None = None
     input_tokens: int = 0
     output_tokens: int = 0
     thinking_tokens: int = 0
@@ -94,8 +94,8 @@ class UsageDataIn(BaseModel):
     request_count: int = 1
     latency_ms: float = 0.0
     status: str = "success"
-    http_status_code: Optional[int] = None
-    error_type: Optional[str] = None
+    http_status_code: int | None = None
+    error_type: str | None = None
     metadata: dict[str, Any] = Field(default_factory=dict)
     capture_content: bool = False
 
@@ -106,7 +106,7 @@ class UsageResponse(BaseModel):
     provider_id: int
     model_id: int
     internal_request_id: str
-    provider_request_id: Optional[str]
+    provider_request_id: str | None
     timestamp: datetime
     input_tokens: int
     output_tokens: int
@@ -123,8 +123,8 @@ class UsageResponse(BaseModel):
     request_count: int
     latency_ms: float
     status: str
-    http_status_code: Optional[int]
-    error_type: Optional[str]
+    http_status_code: int | None
+    error_type: str | None
     metadata_json: dict[str, Any]
     capture_content: bool
     model_config = ConfigDict(from_attributes=True)

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/backend/app/services/usage_service.py

@@ -1,6 +1,6 @@
 from __future__ import annotations
 
-from datetime import datetime
+from datetime import datetime, timezone
 from typing import Any
 
 from sqlalchemy.orm import Session
@@ -46,13 +46,18 @@ def _get_or_create_model(db: Session, provider_id: int, model_name: str) -> Mode
     return model
 
 
-def get_applicable_pricing(db: Session, model_id: int, timestamp: datetime) -> ModelPricing | None:
+def get_applicable_pricing(
+    db: Session, model_id: int, timestamp: datetime
+) -> ModelPricing | None:
     pricing = (
         db.query(ModelPricing)
         .filter(
             ModelPricing.model_id == model_id,
             ModelPricing.effective_from <= timestamp,
-            ((ModelPricing.effective_to.is_(None)) | (ModelPricing.effective_to >= timestamp)),
+            (
+                (ModelPricing.effective_to.is_(None))
+                | (ModelPricing.effective_to >= timestamp)
+            ),
         )
         .order_by(ModelPricing.effective_from.desc())
         .first()
@@ -71,7 +76,8 @@ def create_usage(db: Session, payload: dict[str, Any]) -> ApiUsage:
     project = _get_or_create_project(db, payload["project"])
     provider = _get_or_create_provider(db, payload["provider"])
     model = _get_or_create_model(db, provider.id, payload["model"])
-    timestamp = payload.get("timestamp") or datetime.utcnow()
+    # timestamp = payload.get("timestamp") or datetime.utcnow()
+    timestamp = payload.get("timestamp") or datetime.now(timezone.utc)
     pricing = get_applicable_pricing(db, model.id, timestamp)
     snapshot = PricingSnapshot(
         input_price_per_1m=getattr(pricing, "input_price_per_1m", 0.0),

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2/llmapi_tracker.egg-info}/PKG-INFO

@@ -1,9 +1,12 @@
 Metadata-Version: 2.4
 Name: llmapi-tracker
-Version: 1.0.0
+Version: 1.0.2
 Summary: Local-first API usage and cost tracking platform
 Author: API Tracker
 License: MIT
+Project-URL: Homepage, https://github.com/Lns9777/API-Usage-Tracker
+Project-URL: Repository, https://github.com/Lns9777/API-Usage-Tracker
+Project-URL: Issues, https://github.com/Lns9777/API-Usage-Tracker/issues
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -27,24 +30,24 @@ Requires-Dist: build>=1.2; extra == "dev"
 Requires-Dist: twine>=5.1; extra == "dev"
 Dynamic: license-file
 
-# API Tracker
+# llmapi-tracker
 
 ## What API Tracker Is
 
-API Tracker is a local-first API usage and cost observability tool. It records request volume, token usage, latency, status, and versioned pricing for models from providers such as OpenAI and Gemini.
+`llmapi-tracker` is a local-first API usage and cost observability platform for LLM applications. It records request counts, token usage, latency, errors, and versioned pricing for provider models such as OpenAI and Gemini.
 
-The project is built to keep data local by default. It stores usage and pricing in a local SQLite database and does not persist prompts, responses, or raw API keys in the application database.
+The project is designed to keep data local by default. It stores usage and pricing in a local SQLite database and does not persist prompts, responses, or raw API keys in the application database.
 
 ## Features
 
 - Local FastAPI backend with SQLite storage
 - Versioned pricing records for historical cost tracking
 - Usage capture for input, output, thinking, cached, and total tokens
-- Cost calculation per request and across analytics views
+- Request-level and analytics-level cost calculation
 - React + Vite dashboard for usage, analytics, providers, models, and pricing
 - SDK wrappers for OpenAI and Gemini
 - Packaged launcher command that starts the local app and opens the browser
-- Open-source repository setup with tests, CI, and release automation
+- Open-source repository with tests, CI, and release automation
 
 ## Installation
 
@@ -65,10 +68,16 @@ npm install
 
 ### Package install
 
-If you install this project as a package, the launcher command is:
+```bash
+pip install llmapi-tracker
+```
+
+If you want optional provider SDK support:
 
 ```bash
-api-tracker
+pip install "llmapi-tracker[openai]"
+pip install "llmapi-tracker[gemini]"
+pip install "llmapi-tracker[all]"
 ```
 
 ## Starting the Application
@@ -88,7 +97,7 @@ npm run dev
 
 ### Packaged app
 
-After building the frontend assets and packaging them into the backend static directory, run:
+After the frontend assets are built and packaged into the backend static directory:
 
 ```bash
 api-tracker
@@ -102,7 +111,7 @@ The launcher starts the backend server and opens the browser to the local dashbo
 
 ```python
 import os
-from sdk.api_tracker import APITracker
+from api_tracker import APITracker
 
 tracker = APITracker(
     project="Pharmacy-AI",
@@ -201,7 +210,7 @@ python scripts/verify_frontend_assets.py
 
 ## Contributing
 
-This repository is intended to be open source and contributor friendly.
+`llmapi-tracker` is intended to be open source and contributor friendly.
 
 Contribution files:
 
@@ -221,5 +230,5 @@ Contribution expectations:
 
 ## License
 
-API Tracker is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
+`llmapi-tracker` is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
 

llmapi_tracker-1.0.2/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+
+[project]
+name = "llmapi-tracker"
+version = "1.0.2"
+description = "Local-first API usage and cost tracking platform"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [
+    { name = "API Tracker" }
+]
+
+dependencies = [
+    "requests>=2.32",
+    "fastapi>=0.115",
+    "uvicorn[standard]>=0.30",
+    "sqlalchemy>=2.0",
+    "pydantic>=2.8",
+]
+
+
+[project.urls]
+Homepage = "https://github.com/Lns9777/API-Usage-Tracker"
+Repository = "https://github.com/Lns9777/API-Usage-Tracker"
+Issues = "https://github.com/Lns9777/API-Usage-Tracker/issues"
+
+
+[project.optional-dependencies]
+openai = ["openai>=1.40"]
+gemini = ["google-genai>=0.7"]
+all = ["openai>=1.40", "google-genai>=0.7"]
+dev = [
+    "pytest>=8.0",
+    "httpx>=0.27",
+    "ruff>=0.6",
+    "build>=1.2",
+    "twine>=5.1",
+]
+
+
+[project.scripts]
+api-tracker = "backend.app.launcher:launch_app"
+
+
+[tool.setuptools]
+package-dir = { "backend" = "backend", "api_tracker" = "sdk/api_tracker" }
+packages = [
+    "backend",
+    "backend.app",
+    "backend.app.routes",
+    "backend.app.services",
+    "api_tracker",
+    "api_tracker.providers",
+]
+
+
+[tool.setuptools.package-data]
+api_tracker = ["py.typed"]
+backend = ["app/static/**/*"]
+
+
+[tool.ruff]
+line-length = 88
+target-version = "py310"
+
+
+[tool.ruff.lint]
+select = [
+    "E",
+    "F",
+    "I",
+    "B",
+    "UP",
+    "RUF",
+    "DTZ",
+]
+ignore = [
+    "B008",
+]

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/tests/test_analytics_routes.py

@@ -1,5 +1,3 @@
-from datetime import datetime
-
 from fastapi.testclient import TestClient
 
 from backend.app.main import app

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/tests/test_paths.py

@@ -1,5 +1,3 @@
-from pathlib import Path
-
 from backend.app import paths
 
 
@@ -13,7 +11,10 @@ def test_database_path_uses_explicit_overrides(monkeypatch, tmp_path):
 
     assert paths.get_data_dir() == data_dir
     assert paths.get_database_path() == data_dir / "api_tracker.db"
-    assert paths.get_database_url() == f"sqlite:///{(data_dir / 'api_tracker.db').as_posix()}"
+    assert (
+        paths.get_database_url()
+        == f"sqlite:///{(data_dir / 'api_tracker.db').as_posix()}"
+    )
 
     monkeypatch.setenv("API_TRACKER_DB_PATH", str(db_path))
     assert paths.get_database_path() == db_path

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/tests/test_routes.py

@@ -1,4 +1,4 @@
-from datetime import datetime
+from datetime import datetime, timezone
 
 from fastapi.testclient import TestClient
 from sqlalchemy import create_engine
@@ -8,7 +8,6 @@ from sqlalchemy.pool import StaticPool
 from backend.app.database import Base, get_db
 from backend.app.main import app
 
-
 engine = create_engine(
     "sqlite://",
     connect_args={"check_same_thread": False},
@@ -36,7 +35,9 @@ def teardown_module():
 
 def test_project_crud():
     client = TestClient(app)
-    response = client.post("/projects", json={"name": "alpha", "description": "A", "environment": "dev"})
+    response = client.post(
+        "/projects", json={"name": "alpha", "description": "A", "environment": "dev"}
+    )
     assert response.status_code == 200
     project_id = response.json()["id"]
 
@@ -52,7 +53,14 @@ def test_project_crud():
 def test_pricing_and_usage_endpoints():
     client = TestClient(app)
     provider = client.post("/providers", json={"name": "openai"}).json()
-    model = client.post("/models", json={"provider_id": provider["id"], "model_name": "gpt-5", "model_type": "text"}).json()
+    model = client.post(
+        "/models",
+        json={
+            "provider_id": provider["id"],
+            "model_name": "gpt-5",
+            "model_type": "text",
+        },
+    ).json()
     client.post(
         "/pricing",
         json={
@@ -62,7 +70,8 @@ def test_pricing_and_usage_endpoints():
             "thinking_price_per_1m": 3.0,
             "cached_input_price_per_1m": 4.0,
             "currency": "USD",
-            "effective_from": datetime.utcnow().isoformat(),
+            # "effective_from": datetime.utcnow().isoformat(),
+            "effective_from": datetime.now(timezone.utc).isoformat(),
             "effective_to": None,
         },
     )
@@ -77,7 +86,8 @@ def test_pricing_and_usage_endpoints():
             "output_tokens": 1000000,
             "thinking_tokens": 1000000,
             "cached_tokens": 1000000,
-            "timestamp": datetime.utcnow().isoformat(),
+            # "timestamp": datetime.now(timezone.utc).isoformat(),
+            "timestamp": datetime.now(timezone.utc).isoformat(),
         },
     )
     assert usage.status_code == 200

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/tests/test_tracker.py

@@ -15,7 +15,9 @@ def test_tracker_records_usage(monkeypatch):
     dummy = DummyTransport()
     tracker.transport = dummy
 
-    usage = tracker.record(model="gpt-5", input_tokens=10, output_tokens=5, total_tokens=15)
+    usage = tracker.record(
+        model="gpt-5", input_tokens=10, output_tokens=5, total_tokens=15
+    )
 
     assert usage.total_tokens == 15
     assert dummy.sent[0]["model"] == "gpt-5"

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.2}/tests/test_usage_service.py

@@ -1,15 +1,17 @@
-from datetime import datetime
+from datetime import datetime, timezone
 
 from sqlalchemy import create_engine
 from sqlalchemy.orm import sessionmaker
 
 from backend.app.database import Base
-from backend.app.models import ModelPricing, Project, Provider, Model
+from backend.app.models import Model, ModelPricing, Project, Provider
 from backend.app.services.usage_service import create_usage, get_applicable_pricing
 
 
 def make_session():
-    engine = create_engine("sqlite:///:memory:", connect_args={"check_same_thread": False})
+    engine = create_engine(
+        "sqlite:///:memory:", connect_args={"check_same_thread": False}
+    )
     Base.metadata.create_all(bind=engine)
     return sessionmaker(bind=engine)()
 
@@ -29,8 +31,10 @@ def seed_pricing(db):
             thinking_price_per_1m=3.0,
             cached_input_price_per_1m=4.0,
             currency="USD",
-            effective_from=datetime(2026, 1, 1),
-            effective_to=datetime(2026, 6, 30),
+            # effective_from=datetime(2026, 1, 1),
+            effective_from=datetime(2026, 1, 1, tzinfo=timezone.utc),
+            # effective_to=datetime(2026, 6, 30),
+            effective_to=datetime(2026, 6, 30, tzinfo=timezone.utc),
         )
     )
     db.commit()
@@ -40,7 +44,12 @@ def seed_pricing(db):
 def test_get_applicable_pricing_returns_version_for_timestamp():
     db = make_session()
     model = seed_pricing(db)
-    pricing = get_applicable_pricing(db, model.id, datetime(2026, 3, 1))
+    # pricing = get_applicable_pricing(db, model.id, datetime(2026, 3, 1))
+    pricing = get_applicable_pricing(
+    db,
+    model.id,
+    datetime(2026, 3, 1, tzinfo=timezone.utc),
+)
     assert pricing is not None
     assert pricing.input_price_per_1m == 1.0
 
@@ -59,7 +68,8 @@ def test_create_usage_applies_pricing_snapshot():
             "output_tokens": 1_000_000,
             "thinking_tokens": 1_000_000,
             "cached_tokens": 1_000_000,
-            "timestamp": datetime(2026, 3, 1),
+            # "timestamp": datetime(2026, 3, 1),
+            "timestamp": datetime(2026, 3, 1, tzinfo=timezone.utc),
         },
     )
     assert usage.total_cost == 10.0

llmapi_tracker-1.0.0/backend/app/routes/__init__.py

@@ -1 +0,0 @@
-from . import analytics, models, pricing, projects, providers, usage

llmapi_tracker-1.0.0/backend/app/routes/analytics.py

@@ -1,91 +0,0 @@
-from fastapi import APIRouter, Depends
-from sqlalchemy import func
-from sqlalchemy.orm import Session
-
-from ..database import get_db
-from ..models import ApiUsage, Model, Project, Provider
-
-router = APIRouter(prefix="/analytics", tags=["Analytics"])
-
-
-@router.get("/overview")
-def overview(db: Session = Depends(get_db)):
-    rows = db.query(ApiUsage).all()
-    count = len(rows)
-    total_tokens = sum(r.total_tokens for r in rows)
-    total_cost = sum(r.total_cost for r in rows)
-    avg_latency = (sum(r.latency_ms for r in rows) / count) if count else 0
-    error_rate = ((sum(1 for r in rows if r.status != "success") / count) * 100) if count else 0
-    return {
-        "requests": count,
-        "tokens": total_tokens,
-        "cost": total_cost,
-        "average_latency_ms": avg_latency,
-        "error_rate": error_rate,
-    }
-
-
-@router.get("/cost")
-def cost(db: Session = Depends(get_db)):
-    rows = db.query(func.date(ApiUsage.timestamp).label("day"), func.sum(ApiUsage.total_cost)).group_by("day").all()
-    return [{"date": str(day), "cost": cost or 0} for day, cost in rows]
-
-
-@router.get("/tokens")
-def tokens(db: Session = Depends(get_db)):
-    rows = db.query(func.date(ApiUsage.timestamp).label("day"), func.sum(ApiUsage.input_tokens), func.sum(ApiUsage.output_tokens), func.sum(ApiUsage.thinking_tokens), func.sum(ApiUsage.cached_tokens)).group_by("day").all()
-    return [{"date": str(day), "input": i or 0, "output": o or 0, "thinking": t or 0, "cached": c or 0} for day, i, o, t, c in rows]
-
-
-@router.get("/latency")
-def latency(db: Session = Depends(get_db)):
-    rows = [row.latency_ms for row in db.query(ApiUsage).all()]
-    if not rows:
-        return {"average": 0, "p50": 0, "p95": 0, "p99": 0}
-    rows.sort()
-    count = len(rows)
-    return {
-        "average": sum(rows) / count,
-        "p50": rows[int(count * 0.5) - 1 if count > 1 else 0],
-        "p95": rows[int(count * 0.95) - 1 if count > 1 else 0],
-        "p99": rows[int(count * 0.99) - 1 if count > 1 else 0],
-    }
-
-
-@router.get("/errors")
-def errors(db: Session = Depends(get_db)):
-    rows = db.query(ApiUsage.error_type, func.count(ApiUsage.id)).filter(ApiUsage.status != "success").group_by(ApiUsage.error_type).all()
-    return [{"error_type": error_type or "Unknown", "count": count} for error_type, count in rows]
-
-
-@router.get("/by-project")
-def by_project(db: Session = Depends(get_db)):
-    rows = (
-        db.query(Project.name, func.count(ApiUsage.id), func.sum(ApiUsage.total_tokens), func.sum(ApiUsage.total_cost), func.avg(ApiUsage.latency_ms))
-        .join(ApiUsage, ApiUsage.project_id == Project.id)
-        .group_by(Project.name)
-        .all()
-    )
-    return [{"project": name, "requests": req or 0, "tokens": tokens or 0, "cost": cost or 0, "latency_ms": latency or 0} for name, req, tokens, cost, latency in rows]
-
-
-@router.get("/by-provider")
-def by_provider(db: Session = Depends(get_db)):
-    rows = (
-        db.query(Provider.name, func.count(ApiUsage.id), func.sum(ApiUsage.total_tokens), func.sum(ApiUsage.total_cost), func.avg(ApiUsage.latency_ms))
-        .join(ApiUsage, ApiUsage.provider_id == Provider.id)
-        .group_by(Provider.name)
-        .all()
-    )
-    return [{"provider": name, "requests": req or 0, "tokens": tokens or 0, "cost": cost or 0, "latency_ms": latency or 0} for name, req, tokens, cost, latency in rows]
-
-
-@router.get("/by-model")
-def by_model(db: Session = Depends(get_db)):
-    rows = (
-        db.query(Model.model_name, func.count(ApiUsage.id), func.sum(ApiUsage.total_tokens), func.sum(ApiUsage.total_cost), func.avg(ApiUsage.latency_ms))
-        .join(ApiUsage, ApiUsage.model_id == Model.id)
-        .group_by(Model.model_name)
-        .all()
-    )
-    return [{"model": name, "requests": req or 0, "tokens": tokens or 0, "cost": cost or 0, "latency_ms": latency or 0} for name, req, tokens, cost, latency in rows]

llmapi_tracker-1.0.0/pyproject.toml

@@ -1,45 +0,0 @@
-[build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "llmapi-tracker"
-version = "1.0.0"
-description = "Local-first API usage and cost tracking platform"
-readme = "README.md"
-requires-python = ">=3.10"
-license = { text = "MIT" }
-authors = [
-  { name = "API Tracker" }
-]
-dependencies = [
-  "requests>=2.32",
-  "fastapi>=0.115",
-  "uvicorn[standard]>=0.30",
-  "sqlalchemy>=2.0",
-  "pydantic>=2.8",
-]
-
-[project.optional-dependencies]
-openai = ["openai>=1.40"]
-gemini = ["google-genai>=0.7"]
-all = ["openai>=1.40", "google-genai>=0.7"]
-dev = ["pytest>=8.0", "httpx>=0.27", "ruff>=0.6", "build>=1.2", "twine>=5.1"]
-
-[project.scripts]
-api-tracker = "backend.app.launcher:launch_app"
-
-[tool.setuptools]
-package-dir = {"backend" = "backend", "api_tracker" = "sdk/api_tracker"}
-packages = [
-  "backend",
-  "backend.app",
-  "backend.app.routes",
-  "backend.app.services",
-  "api_tracker",
-  "api_tracker.providers",
-]
-
-[tool.setuptools.package-data]
-api_tracker = ["py.typed"]
-backend = ["app/static/**/*"]