Metadata-Version: 2.4
Name: promptreview-proxy
Version: 0.1.11
Summary: Local HTTP proxy forwarding engine for PromptReview VS Code extension with API subdomain analytics.
Author-email: PromptReview Team <support@prompt-guard-ai.com>
License-Expression: MIT
Keywords: llm,proxy,fastapi,vscode,promptreview,ai
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.110.0
Requires-Dist: uvicorn>=0.28.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.6.0
Requires-Dist: mitmproxy>=12.0.0

# PromptReview Proxy (`promptreview-proxy`)

`promptreview-proxy` is a lightweight, local HTTP proxy forwarding server for the PromptReview VS Code Extension.

## Features
- **Local HTTP Proxying**: Intercepts outbound LLM traffic from VS Code (`http.proxy`).
- **Cloud Analytics Relay**: Asynchronously logs prompt metadata to your API subdomain (`https://api.prompt-guard-ai.com/v1/prompts`).
- **Dynamic Provider Routing**: Forwards requests to target LLM providers (OpenAI, Anthropic, Groq, Ollama, etc.) and streams responses back to VS Code.

## Quick Start

### Installation
```bash
pip install promptreview-proxy
```

### Usage
Run the proxy server from command line:
```bash
promptreview-proxy
```

## Model routing

The VS Code model identifier is not necessarily an OpenAI API model name. The proxy sends `LLM_DEFAULT_MODEL` (default `gpt-4o`) unless an explicit alias is configured in `LLM_MODEL_ROUTE_MAP`.

For example, to route a VS Code model named `Raptor` to OpenAI's `gpt-4o` model:

```bash
export LLM_DEFAULT_MODEL=gpt-4o
export LLM_MODEL_ROUTE_MAP='{"raptor":"gpt-4o"}'
```

Or configure environment variables:
```bash
export PROXY_PORT=6767
export API_BASE_URL="https://api.prompt-guard-ai.com"
promptreview-proxy
```
