# AptSelect

AptSelect is a local-first desktop utility for deterministic prompt testing and evaluation. It allows developers to batch-test prompts against curated datasets, run parallel executions across multiple Large Language Models (LLMs), and generate hard performance metrics without relying on a cloud backend.

## Technical Architecture
- **Platforms:** macOS, Windows, Linux.
- **Framework:** Built with Electron, Vanilla JavaScript, and native Web Components.
- **Storage:** 100% local. All prompt history, configuration, and evaluation data is stored in a local SQLite database (`aptselect.db`).
- **Security:** API keys are encrypted using the native OS keyring (macOS Keychain, Windows Credential Locker, Linux Secret Service).

## Core Features
- **Parallel Model Testing:** Route a single prompt template to multiple providers (OpenAI, Anthropic, Google Gemini, Mistral, xAI) simultaneously to compare raw JSON outputs, exact token usage, and latency side-by-side.
- **Batch Evaluation & Diagnostics:** Upload CSV datasets to run bulk testing across multiple models. Utilizes a deterministic, manual grading workflow (Pass/Fail) with custom diagnostic tags (e.g., Hallucination, Format Error) to avoid the inaccuracies of automated LLM-as-a-judge.
- **Performance Leaderboards:** Generates comparative metrics based on pass rates, token consumption, and response latency.
- **Automatic Prompt Checkpointing:** Every iteration is automatically saved. Prompts have a branching history allowing developers to fork versions and inject dynamic variables using `{{variable}}` syntax.
- **Parameter Control:** Fine-tune inference settings (Temperature, Top_P, Stop Sequences) on a per-model basis.
- **Request-Level Debugging:** Inspect raw JSON API responses for every execution.

## Licensing & Pricing
- **Evaluation:** Free to download and evaluate indefinitely with no restricted features.
- **Commercial License:** A $29.00 USD one-time purchase for a permanent v1.x license.
- **Model:** No subscriptions, no recurring fees, no cloud lock-in.

## Links
- Homepage: https://aptselect.com
- Pricing: https://aptselect.com/buy/
- User Manual: https://aptselect.com/manual