MiniMe API Reference

The MiniMe local backend provides a comprehensive REST API running entirely on your machine via FastAPI. All endpoints are accessed locally at http://localhost:8000.

Local FastAPI Backend

Written in Python 3.10+, utilizing SQLAlchemy, Pydantic, and SQLite for robust local performance.

Authentication

If using the cloud sync endpoints, OAuth JWT tokens are required. Local endpoints are unrestricted by default due to host binding.

Core Endpoints

POST/api/v1/activities/raw

Log Raw Activity

Ingest a new raw activity event from a tracking source.

Example Request Body

{
  "source": "window",
  "app_name": "VS Code",
  "window_title": "layout.tsx - minime - VS Code"
}

GET/api/v1/activities

List Activities

Retrieve aggregated activities with pagination and filtering.

GET/api/v1/graph/nodes

Get Knowledge Graph

Fetch nodes and edges representing extracted semantic entities.

POST/api/v1/ai/chat

Chat with Activity History

Send a RAG query against your personal activity history.

Example Request Body

{
  "message": "What did I work on yesterday?",
  "model": "llama-3"
}