agentmetrics-server 0.1.0__tar.gz

agentmetrics_server-0.1.0/.gitignore

@@ -0,0 +1,62 @@
+# Generated — dashboard SPA copied here during server build
+api/app/static/
+
+# Python
+__pycache__/
+*.py[cod]
+*.pyo
+.venv/
+.env
+*.egg-info/
+dist/
+build/
+.mypy_cache/
+.ruff_cache/
+.pytest_cache/
+htmlcov/
+.coverage
+coverage.xml
+
+# Node / JS
+node_modules/
+.next/
+.turbo/
+dist/
+build/
+*.tsbuildinfo
+.pnpm-store/
+
+# Env files
+.env
+.env.local
+.env.production
+.env.*.local
+api/.env.local
+dashboard/.env.local
+
+# Build artifacts inside packages
+packages/python/dist/
+packages/python/*.egg-info/
+packages/js/dist/
+packages/js/node_modules/
+
+# Internal docs — never public
+.internal/
+PLAN.md
+CODE.md
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+
+# Docker
+*.log
+.internal
+
+# Local data (SQLite DB when running without Docker)
+data/

agentmetrics_server-0.1.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: agentmetrics-server
+Version: 0.1.0
+Summary: AgentMetrics - self-hosted AI agent observability server
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: alembic>=1.13.1
+Requires-Dist: apscheduler==3.10.4
+Requires-Dist: email-validator==2.1.1
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: httpx==0.27.0
+Requires-Dist: passlib[bcrypt]==1.7.4
+Requires-Dist: pydantic-settings>=2.6.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: python-jose[cryptography]==3.3.0
+Requires-Dist: python-multipart==0.0.9
+Requires-Dist: requests==2.32.3
+Requires-Dist: sqlalchemy>=2.0.30
+Requires-Dist: uvicorn[standard]>=0.29.0
+Provides-Extra: postgres
+Requires-Dist: psycopg2-binary>=2.9.9; extra == 'postgres'
+Description-Content-Type: text/markdown
+
+# agentmetrics-server
+
+[![PyPI](https://img.shields.io/pypi/v/agentmetrics-server?color=6366f1&label=pypi&logo=python&logoColor=white)](https://pypi.org/project/agentmetrics-server)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776AB?logo=python&logoColor=white)](https://pypi.org/project/agentmetrics-server)
+[![License: MIT](https://img.shields.io/badge/license-MIT-6366f1)](../LICENSE)
+
+Self-hosted AgentMetrics API server. Install it once and every agent instrumented with the AgentMetrics SDK reports to your own dashboard showing cost, latency, token usage, tool calls, and failures, with no cloud account and no data leaving your infrastructure.
+
+---
+
+## Install
+
+```bash
+pip install agentmetrics-server
+```
+
+Requires Python 3.11 or later.
+
+---
+
+## Quickstart
+
+Start the server in the foreground:
+
+```bash
+agentmetrics-server
+```
+
+Dashboard → **http://localhost:3099**  
+API → **http://localhost:8099**
+
+Data is stored in `agentmetrics.db` in the current directory by default.
+
+---
+
+## Always running
+
+For continuous 24/7 observation across reboots and crashes, install as a system service instead of running in the foreground:
+
+```bash
+agentmetrics install
+```
+
+This registers the server with systemd on Linux, launchd on macOS, or Task Scheduler on Windows, starts it immediately, and configures it to come back automatically after any restart or crash. The database is stored in a persistent OS data directory so it is never lost across reinstalls.
+
+```bash
+agentmetrics install              # install and start with defaults
+agentmetrics install --port 9000  # custom port
+agentmetrics install --db postgresql://user:pass@localhost/mydb
+
+agentmetrics start                # start a stopped service
+agentmetrics stop                 # stop without uninstalling
+agentmetrics restart              # restart
+agentmetrics status               # show service state and HTTP health check
+agentmetrics uninstall            # remove the service
+```
+
+### Platform behaviour
+
+| Platform | Mechanism | Restarts on crash | Starts on boot |
+|---|---|---|---|
+| Linux (non-root) | systemd user service | yes | yes |
+| Linux (root) | systemd system service | yes | yes |
+| macOS | launchd user agent | yes | yes |
+| Windows | Task Scheduler (ONLOGON) | no | yes (at logon) |
+
+On Linux, the service unit is written to `~/.config/systemd/user/agentmetrics.service` when run as a normal user, or `/etc/systemd/system/agentmetrics.service` when run as root. Logs are available via `journalctl --user -u agentmetrics -f`.
+
+On macOS, the plist is written to `~/Library/LaunchAgents/com.agentmetrics.server.plist` and logs go to `~/Library/Logs/AgentMetrics/`.
+
+---
+
+## Configuration
+
+All options can be passed as flags or set via environment variables.
+
+| Flag | Env var | Default | Description |
+|---|---|---|---|
+| `--port` | `PORT` | `8099` | Port to bind |
+| `--host` | — | `0.0.0.0` | Host to bind |
+| `--db` | `DATABASE_URL` | `sqlite:///./agentmetrics.db` | Database URL |
+| `--open` | — | off | Open browser on startup |
+
+### SQLite (default)
+
+No setup needed. The database is created automatically in the current directory, or in the OS data directory when running as a service.
+
+### PostgreSQL
+
+```bash
+pip install "agentmetrics-server[postgres]"
+agentmetrics-server --db postgresql://user:pass@localhost/agentmetrics
+```
+
+Or as a persistent service:
+
+```bash
+agentmetrics install --db postgresql://user:pass@localhost/agentmetrics
+```
+
+---
+
+## Foreground options
+
+```bash
+agentmetrics-server --port 9000
+agentmetrics-server --host 127.0.0.1     # localhost only
+agentmetrics-server --db postgresql://user:pass@localhost/mydb
+agentmetrics-server --open               # open dashboard in browser on start
+```
+
+---
+
+## Health check
+
+```
+GET /health  →  {"status": "ok"}
+```
+
+---
+
+## License
+
+[MIT](../LICENSE)

agentmetrics_server-0.1.0/README.md

@@ -0,0 +1,124 @@
+# agentmetrics-server
+
+[![PyPI](https://img.shields.io/pypi/v/agentmetrics-server?color=6366f1&label=pypi&logo=python&logoColor=white)](https://pypi.org/project/agentmetrics-server)
+[![Python 3.11+](https://img.shields.io/badge/python-3.11+-3776AB?logo=python&logoColor=white)](https://pypi.org/project/agentmetrics-server)
+[![License: MIT](https://img.shields.io/badge/license-MIT-6366f1)](../LICENSE)
+
+Self-hosted AgentMetrics API server. Install it once and every agent instrumented with the AgentMetrics SDK reports to your own dashboard showing cost, latency, token usage, tool calls, and failures, with no cloud account and no data leaving your infrastructure.
+
+---
+
+## Install
+
+```bash
+pip install agentmetrics-server
+```
+
+Requires Python 3.11 or later.
+
+---
+
+## Quickstart
+
+Start the server in the foreground:
+
+```bash
+agentmetrics-server
+```
+
+Dashboard → **http://localhost:3099**  
+API → **http://localhost:8099**
+
+Data is stored in `agentmetrics.db` in the current directory by default.
+
+---
+
+## Always running
+
+For continuous 24/7 observation across reboots and crashes, install as a system service instead of running in the foreground:
+
+```bash
+agentmetrics install
+```
+
+This registers the server with systemd on Linux, launchd on macOS, or Task Scheduler on Windows, starts it immediately, and configures it to come back automatically after any restart or crash. The database is stored in a persistent OS data directory so it is never lost across reinstalls.
+
+```bash
+agentmetrics install              # install and start with defaults
+agentmetrics install --port 9000  # custom port
+agentmetrics install --db postgresql://user:pass@localhost/mydb
+
+agentmetrics start                # start a stopped service
+agentmetrics stop                 # stop without uninstalling
+agentmetrics restart              # restart
+agentmetrics status               # show service state and HTTP health check
+agentmetrics uninstall            # remove the service
+```
+
+### Platform behaviour
+
+| Platform | Mechanism | Restarts on crash | Starts on boot |
+|---|---|---|---|
+| Linux (non-root) | systemd user service | yes | yes |
+| Linux (root) | systemd system service | yes | yes |
+| macOS | launchd user agent | yes | yes |
+| Windows | Task Scheduler (ONLOGON) | no | yes (at logon) |
+
+On Linux, the service unit is written to `~/.config/systemd/user/agentmetrics.service` when run as a normal user, or `/etc/systemd/system/agentmetrics.service` when run as root. Logs are available via `journalctl --user -u agentmetrics -f`.
+
+On macOS, the plist is written to `~/Library/LaunchAgents/com.agentmetrics.server.plist` and logs go to `~/Library/Logs/AgentMetrics/`.
+
+---
+
+## Configuration
+
+All options can be passed as flags or set via environment variables.
+
+| Flag | Env var | Default | Description |
+|---|---|---|---|
+| `--port` | `PORT` | `8099` | Port to bind |
+| `--host` | — | `0.0.0.0` | Host to bind |
+| `--db` | `DATABASE_URL` | `sqlite:///./agentmetrics.db` | Database URL |
+| `--open` | — | off | Open browser on startup |
+
+### SQLite (default)
+
+No setup needed. The database is created automatically in the current directory, or in the OS data directory when running as a service.
+
+### PostgreSQL
+
+```bash
+pip install "agentmetrics-server[postgres]"
+agentmetrics-server --db postgresql://user:pass@localhost/agentmetrics
+```
+
+Or as a persistent service:
+
+```bash
+agentmetrics install --db postgresql://user:pass@localhost/agentmetrics
+```
+
+---
+
+## Foreground options
+
+```bash
+agentmetrics-server --port 9000
+agentmetrics-server --host 127.0.0.1     # localhost only
+agentmetrics-server --db postgresql://user:pass@localhost/mydb
+agentmetrics-server --open               # open dashboard in browser on start
+```
+
+---
+
+## Health check
+
+```
+GET /health  →  {"status": "ok"}
+```
+
+---
+
+## License
+
+[MIT](../LICENSE)

agentmetrics_server-0.1.0/alembic/env.py

@@ -0,0 +1,45 @@
+import os
+import sys
+from logging.config import fileConfig
+
+from alembic import context
+from sqlalchemy import engine_from_config, pool
+
+sys.path.insert(0, os.path.dirname(os.path.dirname(__file__)))
+
+from app.config import settings
+from app.database import Base
+from app.models import Event, Organization  # noqa: F401
+
+config = context.config
+config.set_main_option("sqlalchemy.url", settings.DATABASE_URL)
+
+if config.config_file_name is not None:
+    fileConfig(config.config_file_name)
+
+target_metadata = Base.metadata
+
+
+def run_migrations_offline() -> None:
+    url = config.get_main_option("sqlalchemy.url")
+    context.configure(url=url, target_metadata=target_metadata, literal_binds=True)
+    with context.begin_transaction():
+        context.run_migrations()
+
+
+def run_migrations_online() -> None:
+    connectable = engine_from_config(
+        config.get_section(config.config_ini_section, {}),
+        prefix="sqlalchemy.",
+        poolclass=pool.NullPool,
+    )
+    with connectable.connect() as connection:
+        context.configure(connection=connection, target_metadata=target_metadata)
+        with context.begin_transaction():
+            context.run_migrations()
+
+
+if context.is_offline_mode():
+    run_migrations_offline()
+else:
+    run_migrations_online()

agentmetrics_server-0.1.0/alembic/script.py.mako

@@ -0,0 +1,25 @@
+"""${message}
+
+Revision ID: ${up_revision}
+Revises: ${down_revision | comma,n}
+Create Date: ${create_date}
+
+"""
+from typing import Sequence, Union
+
+from alembic import op
+import sqlalchemy as sa
+${imports if imports else ""}
+
+revision: str = ${repr(up_revision)}
+down_revision: Union[str, None] = ${repr(down_revision)}
+branch_labels: Union[str, Sequence[str], None] = ${repr(branch_labels)}
+depends_on: Union[str, Sequence[str], None] = ${repr(depends_on)}
+
+
+def upgrade() -> None:
+    ${upgrades if upgrades else "pass"}
+
+
+def downgrade() -> None:
+    ${downgrades if downgrades else "pass"}

agentmetrics_server-0.1.0/alembic/versions/001_initial_schema.py

@@ -0,0 +1,64 @@
+"""initial schema
+
+Revision ID: 001
+Revises:
+Create Date: 2026-03-26
+"""
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy.dialects import postgresql
+
+revision: str = "001"
+down_revision: str | None = None
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    op.create_table(
+        "organizations",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column("email", sa.String(255), unique=True, nullable=False),
+        sa.Column("company_name", sa.String(255), nullable=False),
+        sa.Column("hashed_password", sa.String(255), nullable=False),
+        sa.Column("plan", sa.String(50), server_default="free", nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now()),
+    )
+    op.create_index("ix_organizations_email", "organizations", ["email"])
+
+    op.create_table(
+        "api_keys",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column("org_id", postgresql.UUID(as_uuid=True), sa.ForeignKey("organizations.id", ondelete="CASCADE"), nullable=False),
+        sa.Column("key_hash", sa.String(255), unique=True, nullable=False),
+        sa.Column("name", sa.String(255), server_default="Default"),
+        sa.Column("active", sa.Boolean, server_default="true", nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now()),
+    )
+    op.create_index("ix_api_keys_org_id", "api_keys", ["org_id"])
+
+    op.create_table(
+        "events",
+        sa.Column("id", postgresql.UUID(as_uuid=True), primary_key=True),
+        sa.Column("org_id", postgresql.UUID(as_uuid=True), nullable=False),
+        sa.Column("trace_id", sa.String(255), nullable=False),
+        sa.Column("agent_id", sa.String(255), nullable=False),
+        sa.Column("status", sa.String(50), nullable=False),
+        sa.Column("duration_ms", sa.Float, nullable=True),
+        sa.Column("cost_usd", sa.Float, server_default="0"),
+        sa.Column("model", sa.String(100), nullable=True),
+        sa.Column("input_tokens", sa.Float, nullable=True),
+        sa.Column("output_tokens", sa.Float, nullable=True),
+        sa.Column("error_message", sa.Text, nullable=True),
+        sa.Column("timestamp", sa.DateTime(timezone=True), server_default=sa.func.now()),
+    )
+    op.create_index("ix_events_timestamp", "events", ["timestamp"])
+    op.create_index("ix_events_org_agent_ts", "events", ["org_id", "agent_id", "timestamp"])
+
+
+def downgrade() -> None:
+    op.drop_table("events")
+    op.drop_table("api_keys")
+    op.drop_table("organizations")

agentmetrics_server-0.1.0/alembic/versions/002_placeholder.py

@@ -0,0 +1,20 @@
+"""placeholder migration (fills gap between 001 and 003)
+
+Revision ID: 002
+Revises: 001
+Create Date: 2026-03-27
+"""
+from collections.abc import Sequence
+
+revision: str = "002"
+down_revision: str | None = "001"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    pass
+
+
+def downgrade() -> None:
+    pass

agentmetrics_server-0.1.0/alembic/versions/003_password_reset.py

@@ -0,0 +1,41 @@
+"""supabase auth migration
+
+Revision ID: 003
+Revises: 002
+Create Date: 2026-03-29
+"""
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+
+revision: str = "003"
+down_revision: str | None = "002"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Drop custom auth columns no longer needed
+    op.drop_column("organizations", "hashed_password")
+
+    # Add Supabase user ID for JWT-based auth
+    op.add_column(
+        "organizations",
+        sa.Column("supabase_user_id", sa.String(255), nullable=True),
+    )
+    op.create_index(
+        "ix_organizations_supabase_user_id",
+        "organizations",
+        ["supabase_user_id"],
+        unique=True,
+    )
+
+
+def downgrade() -> None:
+    op.drop_index("ix_organizations_supabase_user_id", table_name="organizations")
+    op.drop_column("organizations", "supabase_user_id")
+    op.add_column(
+        "organizations",
+        sa.Column("hashed_password", sa.String(255), nullable=False, server_default=""),
+    )

agentmetrics_server-0.1.0/alembic/versions/004_data_integrity.py

@@ -0,0 +1,34 @@
+"""data integrity: FK on events, indexes, token type fix
+
+Revision ID: 004
+Revises: 003
+Create Date: 2026-03-31
+"""
+from collections.abc import Sequence
+
+from alembic import op
+
+revision: str = "004"
+down_revision: str | None = "003"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def upgrade() -> None:
+    # Add FK from events.org_id → organizations.id with cascade delete
+    op.create_foreign_key(
+        "fk_events_org_id",
+        "events",
+        "organizations",
+        ["org_id"],
+        ["id"],
+        ondelete="CASCADE",
+    )
+
+    # Add standalone index on events.org_id for fast per-org queries
+    op.create_index("ix_events_org_id", "events", ["org_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_events_org_id", table_name="events")
+    op.drop_constraint("fk_events_org_id", "events", type_="foreignkey")

agentmetrics_server-0.1.0/alembic/versions/005_agents_metadata.py

@@ -0,0 +1,65 @@
+"""agents table + metadata JSONB on events
+
+Revision ID: 005
+Revises: 004
+Create Date: 2026-03-31
+"""
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import inspect
+from sqlalchemy.dialects.postgresql import JSONB, UUID
+
+revision: str = "005"
+down_revision: str | None = "004"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def _tables():
+    return inspect(op.get_bind()).get_table_names()
+
+def _columns(table):
+    return [c["name"] for c in inspect(op.get_bind()).get_columns(table)]
+
+def _indexes(table):
+    return [i["name"] for i in inspect(op.get_bind()).get_indexes(table)]
+
+
+def upgrade() -> None:
+    tables = _tables()
+
+    if "agents" not in tables:
+        op.create_table(
+            "agents",
+            sa.Column("id", UUID(as_uuid=True), primary_key=True, server_default=sa.text("gen_random_uuid()")),
+            sa.Column("org_id", UUID(as_uuid=True), sa.ForeignKey("organizations.id", ondelete="CASCADE"), nullable=False),
+            sa.Column("agent_id", sa.String(255), nullable=False),
+            sa.Column("display_name", sa.String(255), nullable=True),
+            sa.Column("description", sa.Text, nullable=True),
+            sa.Column("environment", sa.String(50), nullable=True),
+            sa.Column("tags", JSONB, nullable=True),
+            sa.Column("first_seen", sa.DateTime(timezone=True), server_default=sa.text("now()")),
+            sa.Column("last_seen", sa.DateTime(timezone=True), server_default=sa.text("now()")),
+        )
+        if "ix_agents_org_agent" not in _indexes("agents"):
+            op.create_index("ix_agents_org_agent", "agents", ["org_id", "agent_id"], unique=True)
+
+    existing_cols = _columns("events")
+    for col, typ in [
+        ("metadata",    JSONB),
+        ("step_count",  sa.Integer),
+        ("tool_calls",  sa.Integer),
+        ("environment", sa.String(50)),
+        ("version",     sa.String(50)),
+    ]:
+        if col not in existing_cols:
+            op.add_column("events", sa.Column(col, typ, nullable=True))
+
+
+def downgrade() -> None:
+    for col in ("version", "environment", "tool_calls", "step_count", "metadata"):
+        op.drop_column("events", col)
+    op.drop_index("ix_agents_org_agent", table_name="agents")
+    op.drop_table("agents")

agentmetrics_server-0.1.0/alembic/versions/006_steps_table.py

@@ -0,0 +1,59 @@
+"""steps table: per-step tracing within an agent run
+
+Revision ID: 006
+Revises: 005
+Create Date: 2026-03-31
+"""
+from collections.abc import Sequence
+
+import sqlalchemy as sa
+from alembic import op
+from sqlalchemy import inspect
+from sqlalchemy.dialects.postgresql import JSONB, UUID
+
+revision: str = "006"
+down_revision: str | None = "005"
+branch_labels: str | Sequence[str] | None = None
+depends_on: str | Sequence[str] | None = None
+
+
+def _tables():
+    return inspect(op.get_bind()).get_table_names()
+
+def _indexes(table):
+    return [i["name"] for i in inspect(op.get_bind()).get_indexes(table)]
+
+
+def upgrade() -> None:
+    if "steps" not in _tables():
+        op.create_table(
+            "steps",
+            sa.Column("id", UUID(as_uuid=True), primary_key=True, server_default=sa.text("gen_random_uuid()")),
+            sa.Column("event_id", UUID(as_uuid=True), sa.ForeignKey("events.id", ondelete="CASCADE"), nullable=False),
+            sa.Column("org_id", UUID(as_uuid=True), sa.ForeignKey("organizations.id", ondelete="CASCADE"), nullable=False),
+            sa.Column("trace_id", sa.String(255), nullable=False),
+            sa.Column("step_name", sa.String(255), nullable=False),
+            sa.Column("step_type", sa.String(50), nullable=True),
+            sa.Column("status", sa.String(50), nullable=False),
+            sa.Column("duration_ms", sa.Float, nullable=True),
+            sa.Column("model", sa.String(100), nullable=True),
+            sa.Column("input_tokens", sa.Integer, nullable=True),
+            sa.Column("output_tokens", sa.Integer, nullable=True),
+            sa.Column("cost_usd", sa.Float, default=0.0),
+            sa.Column("error_message", sa.Text, nullable=True),
+            sa.Column("metadata", JSONB, nullable=True),
+            sa.Column("started_at", sa.DateTime(timezone=True), nullable=True),
+            sa.Column("ended_at", sa.DateTime(timezone=True), nullable=True),
+            sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.text("now()")),
+        )
+        indexes = _indexes("steps")
+        if "ix_steps_event_id" not in indexes:
+            op.create_index("ix_steps_event_id", "steps", ["event_id"])
+        if "ix_steps_org_trace" not in indexes:
+            op.create_index("ix_steps_org_trace", "steps", ["org_id", "trace_id"])
+
+
+def downgrade() -> None:
+    op.drop_index("ix_steps_org_trace", table_name="steps")
+    op.drop_index("ix_steps_event_id", table_name="steps")
+    op.drop_table("steps")