llmapi-tracker 1.0.0__py3-none-any.whl

backend/app/static/index.html

@@ -0,0 +1,13 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>API Tracker</title>
+    <script type="module" crossorigin src="/assets/index-jlcpybVb.js"></script>
+    <link rel="stylesheet" crossorigin href="/assets/index-3YVy8dav.css">
+  </head>
+  <body>
+    <div id="root"></div>
+  </body>
+</html>

llmapi_tracker-1.0.0.dist-info/METADATA

@@ -0,0 +1,225 @@
+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).
+

llmapi_tracker-1.0.0.dist-info/RECORD

@@ -0,0 +1,38 @@
+api_tracker/__init__.py,sha256=fztTpIXeSDMK1-QazrDvVYb0wkKcygk7bdhA6Mk4hew,179
+api_tracker/client.py,sha256=s2LrRyRXanCIb8MzrvftpqWvJzQvgX2lLIe2BQDowkc,902
+api_tracker/models.py,sha256=CbE8c51jIsICH5KhsvHoQmCG6V432tqhmIHOrQeLTZ4,789
+api_tracker/pricing.py,sha256=ZgKphx-GntY3j6xaGJGbcWXm5aF9OFvegjipiSAOIj8,1522
+api_tracker/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+api_tracker/tracker.py,sha256=qUyz8UAWaP7hGj-vKJdzmPL2nIAU-KIlFwtJeFVeR0A,1865
+api_tracker/transport.py,sha256=1MAH7dBYNeIfUi4kKTpduzC9V-HhXFHgJyHb4Px3tqc,784
+api_tracker/providers/__init__.py,sha256=yy8nMA1N1m4WZ0C4gGLt7V-TWbN8U5KEwY0GS-X1_rc,132
+api_tracker/providers/gemini.py,sha256=1rgtAwWcdJy0YteyeMuwmWWnn6VjUsTnOT1qw59UMMw,1628
+api_tracker/providers/openai.py,sha256=k46gt0xlRvj7FUHr1QJ-XkxpSS3WXdmSLKg0DP0a8qg,1584
+backend/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+backend/app/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+backend/app/database.py,sha256=C9yhEByWHwqEN7DghbBFJYzenwNUKhaVFisqJTAGJG4,595
+backend/app/frontend.py,sha256=cmiD7yvqmZTdQ9umapXAd2sgFgjXV8kCNG03dLDuaAc,901
+backend/app/launcher.py,sha256=E5M2YYlVK-WyFaFp9woNay1d6hzL2q--ZAVJ6bnJN_I,536
+backend/app/main.py,sha256=NPH1fHu6IbcWDBXArDQbRPTBuHmPcYQ_SNwzIBrOv9U,1524
+backend/app/models.py,sha256=U7ON2GTajfbdYNVxCnrjyls6HEnwnsQDJIkX7Mo4GJQ,4825
+backend/app/paths.py,sha256=5gIKCC4ixaZ4oThlmJNg7IMs8Rr9tiEtoBNylS15f_Q,1617
+backend/app/schemas.py,sha256=0ZXb3L90uJZAQu9XqSMQbvWQHrJyW7RMcwWEPvcY22s,3123
+backend/app/routes/__init__.py,sha256=jjSfbS4hkByEa5U4Ax2TL-xTOu3RtxHe7mJo0bJ5aYo,69
+backend/app/routes/analytics.py,sha256=pmgB3xhqrh_wik7NfHgjMwkcdBnyrkHEAAgCAxrqsfQ,3884
+backend/app/routes/models.py,sha256=oU-JNWsgps-ThNXDJYEw7CzblVjJQtfV8r5ReHNZB3M,820
+backend/app/routes/pricing.py,sha256=tsf7R1W7LQw6FXhvA1ElRQi7rRvEB5CGENaYz-re6Hg,1520
+backend/app/routes/projects.py,sha256=Q9hojYTVnPgWT1QePwmPylJZCz54J-xxrPip30shYtY,1899
+backend/app/routes/providers.py,sha256=aQ6hnyzRA-EVjoRxg1Y0GnSFTKFq1nLWuDYIaK7r_Vg,772
+backend/app/routes/usage.py,sha256=ZaQ1HVSDYcjP0nkVmSMEwZOM_UtHISpuZ1H9JytBLFk,972
+backend/app/services/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+backend/app/services/cost_service.py,sha256=GD8d8FbUX_eeCGMo6UU1OLsn0kLr-dZa9-cLvPy57u8,1041
+backend/app/services/usage_service.py,sha256=iFRNTuVuz11gBQUliGG6q0SQQ3wY9TG83ycBgu2LJUA,4273
+backend/app/static/index.html,sha256=Pw6elIGAHhgPJkdiSN0RWzvaZOY7PibQwYHlQgSpxaM,396
+backend/app/static/assets/index-3YVy8dav.css,sha256=gJnRjHH4LORyhhv0B90nVnn6Wjyl24wP8pb5qyPVdE4,6085
+backend/app/static/assets/index-jlcpybVb.js,sha256=YT-ymP2ps_B2h5nkrVe864a4SGeP7rz8Z7bhkomY2eY,288914
+llmapi_tracker-1.0.0.dist-info/licenses/LICENSE,sha256=zyJy1QhELa2cDPrRMG_QKs1Jt2c1LsCYbFHKji_SfV8,1081
+llmapi_tracker-1.0.0.dist-info/METADATA,sha256=_398kzUAet43Ylmg_mNO57QMgjtnOFMqV9u-Ord_--I,5737
+llmapi_tracker-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+llmapi_tracker-1.0.0.dist-info/entry_points.txt,sha256=TQwWQNj3F4Bdg6aVhfSI9UVgvUUY4ipJ4YTpMGsx3dk,64
+llmapi_tracker-1.0.0.dist-info/top_level.txt,sha256=9zVP1897FXZEdCmec-fJYXHFGiqy2bBLEpNwKzXhrqE,20
+llmapi_tracker-1.0.0.dist-info/RECORD,,

llmapi_tracker-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

llmapi_tracker-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+api-tracker = backend.app.launcher:launch_app

llmapi_tracker-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 API Tracker contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

llmapi_tracker-1.0.0.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+api_tracker
+backend