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

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

@@ -1,225 +1,234 @@
-Metadata-Version: 2.4
-Name: llmapi-tracker
-Version: 1.0.0
-Summary: Local-first API usage and cost tracking platform
-Author: API Tracker
-License: MIT
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests>=2.32
-Requires-Dist: fastapi>=0.115
-Requires-Dist: uvicorn[standard]>=0.30
-Requires-Dist: sqlalchemy>=2.0
-Requires-Dist: pydantic>=2.8
-Provides-Extra: openai
-Requires-Dist: openai>=1.40; extra == "openai"
-Provides-Extra: gemini
-Requires-Dist: google-genai>=0.7; extra == "gemini"
-Provides-Extra: all
-Requires-Dist: openai>=1.40; extra == "all"
-Requires-Dist: google-genai>=0.7; extra == "all"
-Provides-Extra: dev
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: httpx>=0.27; extra == "dev"
-Requires-Dist: ruff>=0.6; extra == "dev"
-Requires-Dist: build>=1.2; extra == "dev"
-Requires-Dist: twine>=5.1; extra == "dev"
-Dynamic: license-file
-
-# API 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.
-
-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.
-
-## 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
-- 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
-
-## Installation
-
-### Prerequisites
-
-- Python 3.10 or newer
-- Node.js 20 or newer for frontend development
-
-### Local development install
-
-```bash
-python -m venv .venv
-.venv\Scripts\activate
-pip install -r requirements.txt
-cd frontend
-npm install
-```
-
-### Package install
-
-If you install this project as a package, the launcher command is:
-
-```bash
-api-tracker
-```
-
-## Starting the Application
-
-### Backend only
-
-```bash
-uvicorn backend.app.main:app --reload
-```
-
-### Frontend only
-
-```bash
-cd frontend
-npm run dev
-```
-
-### Packaged app
-
-After building the frontend assets and packaging them into the backend static directory, run:
-
-```bash
-api-tracker
-```
-
-The launcher starts the backend server and opens the browser to the local dashboard.
-
-## SDK Usage
-
-### Initialize the SDK
-
-```python
-import os
-from sdk.api_tracker import APITracker
-
-tracker = APITracker(
-    project="Pharmacy-AI",
-    backend_url=os.getenv("TRACKER_BACKEND_URL", "http://localhost:8000"),
-    openai_api_key=os.getenv("OPENAI_API_KEY"),
-    gemini_api_key=os.getenv("GEMINI_API_KEY"),
-)
-```
-
-### OpenAI
-
-```python
-response = tracker.openai.chat(
-    model="gpt-5",
-    messages=[{"role": "user", "content": "Analyze this prescription"}],
-)
-```
-
-### Gemini
-
-```python
-response = tracker.gemini.generate(
-    model="gemini-2.5-flash",
-    contents="Analyze this prescription",
-)
-```
-
-The SDK reads usage metadata from the provider response and sends it to the local backend automatically.
-
-## Database Location
-
-By default, the SQLite database is stored in a stable user data directory so it survives uninstall and reinstall.
-
-The path is resolved in this order:
-
-1. `API_TRACKER_DB_PATH` if set
-2. `DATABASE_URL` if set
-3. A user-data location based on the operating system
-
-Typical defaults:
-
-- Windows: `%LOCALAPPDATA%\\APITracker\\api_tracker.db`
-- macOS/Linux: `~/.local/share/APITracker/api_tracker.db`
-
-If the preferred user-data directory cannot be created, the app falls back to a writable local `.api-tracker-data/` directory in the current workspace.
-
-## Configuration
-
-Environment variables:
-
-```bash
-DATABASE_URL=sqlite:///./api_tracker.db
-API_TRACKER_DATA_DIR=
-API_TRACKER_DB_PATH=
-API_TRACKER_HOST=127.0.0.1
-API_TRACKER_PORT=8000
-API_TRACKER_OPEN_BROWSER=true
-OPENAI_API_KEY=
-GEMINI_API_KEY=
-TRACKER_BACKEND_URL=http://localhost:8000
-VITE_API_BASE_URL=http://localhost:8000
-```
-
-Notes:
-
-- `DATABASE_URL` overrides the database connection string
-- `API_TRACKER_DATA_DIR` sets the user-data root used for SQLite storage
-- `API_TRACKER_DB_PATH` points directly to a specific SQLite file
-- `API_TRACKER_OPEN_BROWSER=false` disables browser auto-open for the launcher
-
-## Development Setup
-
-### Backend
-
-```bash
-python -m compileall backend sdk tests
-pytest -q
-```
-
-### Frontend
-
-```bash
-cd frontend
-npm run build
-```
-
-### Packaging assets
-
-```bash
-cd frontend
-npm run build
-cd ..
-python scripts/package_frontend_assets.py
-python scripts/verify_frontend_assets.py
-```
-
-## Contributing
-
-This repository is intended to be open source and contributor friendly.
-
-Contribution files:
-
-- [`CONTRIBUTING.md`](L:/Personal/APITracker/CONTRIBUTING.md)
-- [`CODE_OF_CONDUCT.md`](L:/Personal/APITracker/CODE_OF_CONDUCT.md)
-- [`SECURITY.md`](L:/Personal/APITracker/SECURITY.md)
-- [`CHANGELOG.md`](L:/Personal/APITracker/CHANGELOG.md)
-- [`LICENSE`](L:/Personal/APITracker/LICENSE)
-
-Contribution expectations:
-
-- Open changes through pull requests
-- Require review before merge
-- Keep the app local-first
-- Avoid storing prompts, responses, or raw API keys
-- Add tests for behavior changes
-
-## License
-
-API Tracker is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
-
+Metadata-Version: 2.4
+Name: llmapi-tracker
+Version: 1.0.3
+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
+Requires-Dist: requests>=2.32
+Requires-Dist: fastapi>=0.115
+Requires-Dist: uvicorn[standard]>=0.30
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: pydantic>=2.8
+Provides-Extra: openai
+Requires-Dist: openai>=1.40; extra == "openai"
+Provides-Extra: gemini
+Requires-Dist: google-genai>=0.7; extra == "gemini"
+Provides-Extra: all
+Requires-Dist: openai>=1.40; extra == "all"
+Requires-Dist: google-genai>=0.7; extra == "all"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: httpx>=0.27; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: twine>=5.1; extra == "dev"
+Dynamic: license-file
+
+# llmapi-tracker
+
+## What API Tracker Is
+
+`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 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
+- 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 with tests, CI, and release automation
+
+## Installation
+
+### Prerequisites
+
+- Python 3.10 or newer
+- Node.js 20 or newer for frontend development
+
+### Local development install
+
+```bash
+python -m venv .venv
+.venv\Scripts\activate
+pip install -r requirements.txt
+cd frontend
+npm install
+```
+
+### Package install
+
+```bash
+pip install llmapi-tracker
+```
+
+If you want optional provider SDK support:
+
+```bash
+pip install "llmapi-tracker[openai]"
+pip install "llmapi-tracker[gemini]"
+pip install "llmapi-tracker[all]"
+```
+
+## Starting the Application
+
+### Backend only
+
+```bash
+uvicorn backend.app.main:app --reload
+```
+
+### Frontend only
+
+```bash
+cd frontend
+npm run dev
+```
+
+### Packaged app
+
+After the frontend assets are built and packaged into the backend static directory:
+
+```bash
+api-tracker
+```
+
+The launcher starts the backend server and opens the browser to the local dashboard.
+
+## SDK Usage
+
+### Initialize the SDK
+
+```python
+import os
+from api_tracker import APITracker
+
+tracker = APITracker(
+    project="Pharmacy-AI",
+    backend_url=os.getenv("TRACKER_BACKEND_URL", "http://localhost:8000"),
+    openai_api_key=os.getenv("OPENAI_API_KEY"),
+    gemini_api_key=os.getenv("GEMINI_API_KEY"),
+)
+```
+
+### OpenAI
+
+```python
+response = tracker.openai.chat(
+    model="gpt-5",
+    messages=[{"role": "user", "content": "Analyze this prescription"}],
+)
+```
+
+### Gemini
+
+```python
+response = tracker.gemini.generate(
+    model="gemini-2.5-flash",
+    contents="Analyze this prescription",
+)
+```
+
+The SDK reads usage metadata from the provider response and sends it to the local backend automatically.
+
+## Database Location
+
+By default, the SQLite database is stored in a stable user data directory so it survives uninstall and reinstall.
+
+The path is resolved in this order:
+
+1. `API_TRACKER_DB_PATH` if set
+2. `DATABASE_URL` if set
+3. A user-data location based on the operating system
+
+Typical defaults:
+
+- Windows: `%LOCALAPPDATA%\\APITracker\\api_tracker.db`
+- macOS/Linux: `~/.local/share/APITracker/api_tracker.db`
+
+If the preferred user-data directory cannot be created, the app falls back to a writable local `.api-tracker-data/` directory in the current workspace.
+
+## Configuration
+
+Environment variables:
+
+```bash
+DATABASE_URL=sqlite:///./api_tracker.db
+API_TRACKER_DATA_DIR=
+API_TRACKER_DB_PATH=
+API_TRACKER_HOST=127.0.0.1
+API_TRACKER_PORT=8000
+API_TRACKER_OPEN_BROWSER=true
+OPENAI_API_KEY=
+GEMINI_API_KEY=
+TRACKER_BACKEND_URL=http://localhost:8000
+VITE_API_BASE_URL=http://localhost:8000
+```
+
+Notes:
+
+- `DATABASE_URL` overrides the database connection string
+- `API_TRACKER_DATA_DIR` sets the user-data root used for SQLite storage
+- `API_TRACKER_DB_PATH` points directly to a specific SQLite file
+- `API_TRACKER_OPEN_BROWSER=false` disables browser auto-open for the launcher
+
+## Development Setup
+
+### Backend
+
+```bash
+python -m compileall backend sdk tests
+pytest -q
+```
+
+### Frontend
+
+```bash
+cd frontend
+npm run build
+```
+
+### Packaging assets
+
+```bash
+cd frontend
+npm run build
+cd ..
+python scripts/package_frontend_assets.py
+python scripts/verify_frontend_assets.py
+```
+
+## Contributing
+
+`llmapi-tracker` is intended to be open source and contributor friendly.
+
+Contribution files:
+
+- [`CONTRIBUTING.md`](L:/Personal/APITracker/CONTRIBUTING.md)
+- [`CODE_OF_CONDUCT.md`](L:/Personal/APITracker/CODE_OF_CONDUCT.md)
+- [`SECURITY.md`](L:/Personal/APITracker/SECURITY.md)
+- [`CHANGELOG.md`](L:/Personal/APITracker/CHANGELOG.md)
+- [`LICENSE`](L:/Personal/APITracker/LICENSE)
+
+Contribution expectations:
+
+- Open changes through pull requests
+- Require review before merge
+- Keep the app local-first
+- Avoid storing prompts, responses, or raw API keys
+- Add tests for behavior changes
+
+## License
+
+`llmapi-tracker` is released under the MIT License. See [`LICENSE`](L:/Personal/APITracker/LICENSE).
+

{llmapi_tracker-1.0.0 → llmapi_tracker-1.0.3}/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.3}/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.3}/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.3}/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.3}/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.3}/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.3}/backend/app/paths.py

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