Repository navigation
Expand file tree
/
Copy path.env.example
More file actions
146 lines (117 loc) · 6.55 KB
/
Copy path.env.example
File metadata and controls
146 lines (117 loc) · 6.55 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
# JARVIS — example environment file
# ===================================================================
# EVERYTHING HERE IS OPTIONAL in the default (bridge) mode. JARVIS runs
# perfectly with an empty file — the bridge authenticates off your Claude Code
# login, and voice input and output both fall back to the browser's own speech.
# Copy this to .env.local, and add only what you actually want to change.
#
# The one line worth adding is ELEVENLABS_API_KEY, down in the BRIDGE section:
# it gives you a much better voice and Scribe transcription. The free tier is
# plenty for a demo. Never commit a real key.
#
# Two audiences read these variables:
# - the BRIDGE (the Node server, bridge/server.mjs) reads the JARVIS_* and
# ELEVENLABS_API_KEY variables from its shell environment.
# - the FRONTEND (the Vite app) reads the VITE_* variables from .env.local.
# Only VITE_-prefixed values ever reach the browser.
# ===================================================================
# BRIDGE (the server) — read from the shell that runs `npm run bridge`
# ===================================================================
# These are shown with their defaults. Leave them unset to accept the default.
# Port the bridge listens on (WebSocket + a few HTTP endpoints). Default 8787.
# If you change it, change VITE_BRIDGE_URL to match.
# JARVIS_BRIDGE_PORT=8787
# Interface the bridge listens on. Default 127.0.0.1 — this machine only.
# Setting anything else puts the agent on your network; don't, unless you have
# put your own authentication in front of it.
# JARVIS_BRIDGE_HOST=127.0.0.1
# Extra hostnames the bridge answers to, comma separated. Requests addressed to
# any other name are refused, which is what stops DNS rebinding. Default: none
# beyond localhost, 127.0.0.1 and [::1].
# JARVIS_ALLOWED_HOSTS=
# The model the bridge asks Claude Code to run. Default claude-opus-5.
# JARVIS_MODEL=claude-opus-5
# Reasoning effort. Default medium.
# JARVIS_EFFORT=medium
# Allow effectful tools (send, tap, delete, install, pay). Off by default, so
# JARVIS can look at anything and change nothing. `npm run bridge:writes` turns
# it on for you (via --writes). Read the decideTool gate in bridge/policy.mjs first.
# JARVIS_ALLOW_WRITES=0
# Which MCP servers from ~/.claude.json JARVIS gets, comma separated. Unset
# passes every configured server; an empty value passes none. Each one is
# something a voice agent that reads web pages can be talked into calling, so
# name only what you use. Default: all.
# JARVIS_MCP_SERVERS=
# Let the connectors attached to your claude.ai account (mail, drive,
# calendar and other account connectors) into the session too. Off by default. Default 0.
# JARVIS_ACCOUNT_CONNECTORS=0
# Built-in capabilities to leave out, comma separated: browser (your own
# signed-in Chrome), camera, interface (the ui_* retinting tools). Left-out
# tools never reach the model, which also trims every turn's input. Default:
# none.
# JARVIS_DISABLE=
# Extra browser origins allowed to open the agent WebSocket, comma separated.
# Local dev origins are already allowed; add others only if you serve the app
# from a different address. Default: none.
# JARVIS_ALLOWED_ORIGINS=
# Allow clients that send no Origin header at all (curl, scripts, native apps).
# Off by default, because that is also what local malware looks like. Default 0.
# JARVIS_ALLOW_NO_ORIGIN=0
# The agent's working directory. Its file tools (Read, Grep, Glob, and Write /
# Edit when writes are on) are confined to this folder, the system temp
# directory and JARVIS_FILE_ROOTS. Credential locations (~/.ssh, ~/.claude,
# .env files …) are refused even inside those. Default: ~/.jarvis/workspace.
# JARVIS_WORKSPACE=
# Extra directories the file tools may use and the /file endpoint may serve
# images from, comma separated — a Pictures folder, an external drive of
# footage. Default: none.
# JARVIS_FILE_ROOTS=
# Keep a transcript of every session, the way Claude Code does, under
# ~/.claude/projects. Off by default: nothing reads them back, and they hold
# every tool result verbatim. Default 0.
# JARVIS_KEEP_TRANSCRIPTS=0
# Run the agent (the Claude Code CLI the SDK starts) through this executable
# instead of the bundled one — typically a sandbox wrapper that execs the real
# CLI with the same arguments. Every built-in tool runs inside that process,
# so this is where OS-level confinement belongs. Default: the bundled CLI.
# JARVIS_CLAUDE_EXECUTABLE=
# Log every message the agent sends, including answer text, tool calls and the
# MCP servers that connected, to the bridge's terminal. For debugging only.
# Default 0.
# JARVIS_DEBUG=0
# WSL only: the name of the Windows pipe the browser relay connects to.
# Default: claude-mcp-browser-bridge- followed by your Windows user name.
# JARVIS_CHROME_PIPE=
# ElevenLabs voice id for the bridge's own speech endpoint. Default: George.
# JARVIS_VOICE_ID=JBFqnCBsd6RMkjVDRZzb
# ElevenLabs API key. Optional. With it, JARVIS speaks in the ElevenLabs voice
# and transcribes with ElevenLabs Scribe; without it, everything still works on
# the browser's own speech. If you already have an elevenlabs MCP server in
# ~/.claude.json, the bridge reads the key from there and you can leave this
# blank. Default: none.
# ELEVENLABS_API_KEY=
# ===================================================================
# FRONTEND (Vite) — put these in .env.local
# ===================================================================
# Which brain the browser talks to. Default bridge.
# bridge — talk to the local bridge (recommended). No API key, and every MCP
# server in your Claude Code config is available.
# direct — the browser calls the Claude API itself. Needs VITE_ANTHROPIC_API_KEY.
# VITE_BACKEND=bridge
# Where the bridge listens. Keep the port in step with JARVIS_BRIDGE_PORT above.
# Default ws://localhost:8787.
# VITE_BRIDGE_URL=ws://localhost:8787
# Browser text-to-speech engine, used when no ElevenLabs voice is active.
# Default system.
# system — the browser's built-in speechSynthesis. Instant, on-device.
# kokoro — a neural voice running in the browser. Better sound, slower to start.
# VITE_TTS_ENGINE=system
# Which Kokoro voice, when VITE_TTS_ENGINE=kokoro. Default bm_george.
# VITE_KOKORO_VOICE=bm_george
# Prefer the ElevenLabs voice from the browser when a key is available.
# Default false.
# VITE_USE_ELEVENLABS=false
# Anthropic API key — DIRECT MODE ONLY. Required if and only if
# VITE_BACKEND=direct, and it ships to the browser, so use it only for a local
# demo. The default bridge mode never reads it. Default: none.
# VITE_ANTHROPIC_API_KEY=