setup-assistant · git:20261110.5be8a6c · 2026-11-10 · sha256 5851ef4fb131d3ab
setup-assistant git:20261110.5be8a6cA
Immutable. This exact content never changes and is served at /api/v1/blob/5851ef4fb131d3ab.
No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_lyapztxcg62wxx4s/5851ef4fb131d3ab2df698a1b0ee9b6a09b061cc3b0d3cca3fc13c762beb1b5f.json
Then /plugin install setup-assistant@markdownregistry-lyapztxcg62wxx4s in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.
---
name: setup-assistant
description: Guides through installation, configuration, and first-time setup of the Claude Patent Creator system.
---
# Setup Assistant Skill
Expert system for installing, configuring, and setting up the Claude Patent Creator MCP server.
## When to Use
Installing first time, setting up new environment, configuring authentication, troubleshooting installation, migrating to new machine, updating dependencies, verifying health.
## Quick Setup (about an hour, mostly waiting)
Follow the README's Quick Start; it is the tested path. In short:
```bash
# Mac/Linux (Windows: py -m venv patent-creator-venv, then .\patent-creator-venv\Scripts\...)
cd ~
python3 -m venv patent-creator-venv
patent-creator-venv/bin/pip install git+https://github.com/RobThePCGuy/Claude-Patent-Creator.git
patent-creator-venv/bin/patent-creator setup
```
Setup takes 25-40 minutes without an NVIDIA GPU and ends by testing the connection to Claude Code. Then restart Claude Code and ask: "Search MPEP for claim definiteness". From a plugin, `/claude-patent-creator-standalone:setup-patent-system` does the same steps into the same folder.
## Complete Setup Lifecycle
### Phase 1: Pre-Installation Checks
**Requirements:**
- Python 3.10-3.13 (CI tests 3.11; 3.13 walked end to end)
- 8GB+ RAM (16GB recommended)
- 5GB free disk
- Optional: NVIDIA GPU with CUDA 12.x
**Verify:**
```bash
python3 --version # Should show 3.10-3.13
nvidia-smi # Optional: Check GPU
```
### Phase 2: Virtual Environment and Install
Use the README's folder, `~/patent-creator-venv`, so every README instruction works as written. Nothing needs activating; call the venv's commands by path.
```bash
# Mac/Linux
cd ~
python3 -m venv patent-creator-venv
patent-creator-venv/bin/pip install git+https://github.com/RobThePCGuy/Claude-Patent-Creator.git
# Windows (PowerShell, from cd ~)
py -m venv patent-creator-venv
.\patent-creator-venv\Scripts\pip install git+https://github.com/RobThePCGuy/Claude-Patent-Creator.git
```
From a source checkout instead: `pip install -e .` inside a venv made in the checkout.
### Phase 3: Setup
```bash
~/patent-creator-venv/bin/patent-creator setup # Windows: .\patent-creator-venv\Scripts\patent-creator setup
```
Handles GPU detection (installs the CUDA PyTorch build on NVIDIA and restarts itself), downloads, the index build (25-40 min without an NVIDIA GPU, with progress lines), Graphviz (asks first), BigQuery detection, and registration with a live connection test.
**GPU repairs:** let setup select the wheel for the detected GPU. Older NVIDIA cards need different wheels from recent cards. Follow `${CLAUDE_PLUGIN_ROOT}/docs/GPU_SETUP.md` and test an actual CUDA operation before claiming GPU acceleration works.
### Phase 4: BigQuery Authentication (Optional)
BigQuery adds 100M+ patent search but is NOT required. MPEP search, claims review, EPO analysis, and all other features work without it.
The setup auto-detects existing gcloud credentials. If already authenticated, BigQuery works automatically.
**If the user wants to enable BigQuery later:**
```bash
# One command — opens browser for Google sign-in (free, no credit card)
! gcloud auth application-default login # typed in the Claude Code prompt; in a plain terminal drop the "!"
```
**Do NOT present BigQuery as a failure or required step.** It is a bonus feature.
### Phase 5: MCP Server Registration
Setup registers the server and tests the connection itself. To recheck: `~/patent-creator-venv/bin/patent-creator verify-config`.
**Manual:**
```bash
# Get paths
~/patent-creator-venv/bin/patent-creator verify-config
# Register (use forward slashes!)
claude mcp add --transport stdio claude-patent-creator --scope user -- \
"C:/path/to/venv/Scripts/python.exe" \
"C:/path/to/mcp_server/server.py"
# Verify
claude mcp list
```
**Critical:** Restart Claude Code after registration!
### Phase 6: Configuration Files
Nothing is required. Save optional keys with the config command (they go in `~/.config/claude-patent-creator/config.json`, or `%APPDATA%\claude-patent-creator\config.json` on Windows):
```bash
~/patent-creator-venv/bin/patent-creator config set SERPAPI_API_KEY "key" # patent search, free 250/month (recommended)
~/patent-creator-venv/bin/patent-creator config set GOOGLE_CLOUD_PROJECT my-proj # optional BigQuery search
~/patent-creator-venv/bin/patent-creator config list # everything, with sources
```
ANTHROPIC_API_KEY / OPENAI_API_KEY are only for HyDE with HYDE_BACKEND=api, which is off by default. A `.env` in a source checkout also works.
### Phase 7: Health Check
```bash
~/patent-creator-venv/bin/patent-creator health # Windows: .\patent-creator-venv\Scripts\patent-creator health
```
### Phase 8: Present Results
**Setup is complete when MPEP index is built and MCP server is registered.** BigQuery and EPO OPS are optional enhancements.
Present a clean summary table showing what's ready. Do NOT dump manual setup instructions for optional features. The system is fully functional for:
- MPEP/USC/CFR/EPC/PCT legal search
- Claims analysis (US + EPO)
- Specification analysis (US + EPO)
- Formalities checking (US + EPO + PCT)
- Patent diagram generation (once Graphviz is installed)
- Patent application drafting
Patent search needs a free SerpApi key (recommended) or BigQuery. If one is configured, list patent search as available. If not, say it is one free key away (README Quick Start, Step 3) rather than presenting it as a failure.
**Test with:**
```
"Search MPEP for claim definiteness requirements"
```
**If this works -> Setup complete. Tell the user they're ready.**
## Common Setup Issues
| Issue | Solution |
|-------|----------|
| PyTorch CPU-only | Reinstall PyTorch FIRST |
| MCP not loading | Restart Claude Code, verify with `claude mcp list` |
| Path errors | Use forward slashes (/) not backslashes (\\) |
| BigQuery fails | Re-auth: `gcloud auth application-default login` |
| Index not found | Build: `~/patent-creator-venv/bin/patent-creator setup --rebuild` |
| Import errors | Run the venv's own commands (`~/patent-creator-venv/bin/...`); nothing needs activating |
## Platform-Specific Notes
### Windows
- PowerShell: call `.\patent-creator-venv\Scripts\patent-creator` from `cd ~`; no activation needed
- Git Bash required for MCP commands
- Paths: Always forward slashes in MCP config
- CUDA: Install NVIDIA drivers + toolkit
### Linux
- venv: call `~/patent-creator-venv/bin/patent-creator`; no activation needed
- FAISS-GPU: Available on Linux only
- Permissions: May need sudo
### macOS
- Apple Silicon: builds the index on the CPU (faster than MPS for this job, 25-40 min)
- Intel: Use CPU or external GPU
- Homebrew: May need for dependencies
## Update & Maintenance
### Updating Dependencies
```bash
~/patent-creator-venv/bin/pip install --upgrade git+https://github.com/RobThePCGuy/Claude-Patent-Creator.git
~/patent-creator-venv/bin/patent-creator setup # re-checks, rebuilds only if needed
```
From a source checkout: `git pull`, then `venv/bin/pip install -e . --upgrade` and `venv/bin/python -m pytest -q`.
### Rebuilding Index
```bash
~/patent-creator-venv/bin/patent-creator setup --rebuild
# About 5 minutes with an NVIDIA GPU, 25-40 minutes otherwise
```
### Re-registering MCP
```bash
~/patent-creator-venv/bin/patent-creator setup # re-registers and retests; downloads and index are kept
# Restart Claude Code
```
## Quick Reference
### Essential Commands
```bash
# Setup
~/patent-creator-venv/bin/patent-creator setup
~/patent-creator-venv/bin/patent-creator health
claude mcp list
# Maintenance
~/patent-creator-venv/bin/patent-creator setup --rebuild
~/patent-creator-venv/bin/patent-creator verify-config
# Source checkout only
venv/bin/python -m pytest -q
```
### Critical Files
- `~/.config/claude-patent-creator/config.json` - saved settings and keys (`~/patent-creator-venv/bin/patent-creator config path`)
- `~/.local/share/claude-patent-creator/data/` - downloaded sources and the search index (`PATENT_DATA_DIR` moves it)
- `.env` - environment variables, source checkout only
- `pdfs/` - MPEP PDF files