Metadata-Version: 2.4
Name: localfirst
Version: 0.3.0
Summary: Your hardware runs first. Cloud is the exception, not the rule.
Author: LocalFirst AI
License: MIT
License-File: LICENSE
Keywords: ai,claude,cursor,inspector,llm,local,proxy,routing
Requires-Python: >=3.11
Requires-Dist: fastapi>=0.110
Requires-Dist: flask>=3.0
Requires-Dist: httpx>=0.27
Requires-Dist: lao>=0.1.12
Requires-Dist: psutil>=5.9
Requires-Dist: pydantic>=2.6
Requires-Dist: pyyaml>=6
Requires-Dist: requests>=2.31
Requires-Dist: rich>=13
Requires-Dist: typer>=0.12
Provides-Extra: mcp
Requires-Dist: fastmcp>=2.0; extra == 'mcp'
Description-Content-Type: text/markdown


# LocalFirst

> Your hardware runs first. Cloud is the exception, not the rule.

LocalFirst sits between you and Claude Code. It shows exactly what gets uploaded to Anthropic, blocks secrets before they leave your machine, and runs file operations locally — zero cloud tokens.

## Install

    pip install localfirst

    localfirst claude

## The problem

Claude Code uploads your code to Anthropic on every request. You cannot see what goes up. Your .env files get included even with .claudeignore. A simple session burns $0.07+ before you type anything.

## What LocalFirst does

**1. Inspector** — see every request live, tokens, files, costs

**2. Secret Gate** — block .env and API keys before they reach Anthropic

**3. Local MCP Tools** — grep, find, read, tree, git run locally — 0 cloud tokens

Typical savings: 30-60% of all tokens.

## Setup

    pip install localfirst

    localfirst mcp config

## Usage

    localfirst claude                       # Claude with LocalFirst active

    localfirst claude --mode block_secrets  # block secrets automatically

    localfirst inspect                      # inspector only

    localfirst stats                        # token savings

    localfirst check                        # check tools

---

Built on LAO

