Skip to content

Commit 85fe980

Browse files
authored
Merge pull request #32 from Shishir435/feature/firefox-compatibility
Feature/firefox compatibility
2 parents ca0d0ae + f182281 commit 85fe980

19 files changed

+1090
-154
lines changed

README.md

Lines changed: 37 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -93,9 +93,33 @@
9393

9494
```bash
9595
brew install ollama # macOS
96+
# or visit https://ollama.com for Windows/Linux installers
97+
9698
ollama serve # starts at http://localhost:11434
9799
```
98100

101+
**💡 Quick Setup Script** (Cross-platform):
102+
103+
For easier setup with LAN access and Firefox CORS support:
104+
105+
```bash
106+
# Cross-platform bash script (macOS/Linux/Windows with Git Bash)
107+
./tools/ollama-env.sh firefox # Firefox with CORS + LAN access
108+
./tools/ollama-env.sh chrome # Chrome with LAN access
109+
```
110+
111+
📄 **Script file:** [`tools/ollama-env.sh`](https://github.com/Shishir435/ollama-client/blob/main/tools/ollama-env.sh)
112+
113+
This script automatically:
114+
115+
- Configures Ollama for LAN access (`0.0.0.0`)
116+
- Sets up CORS for Firefox extensions (if needed)
117+
- Shows your local IP address for network access
118+
- Detects your OS (macOS, Linux, Windows) automatically
119+
- Stops any running Ollama instances before starting
120+
121+
If you don't have the script file, you can [download it directly](https://raw.githubusercontent.com/Shishir435/ollama-client/main/tools/ollama-env.sh) or see the full setup guide: [Ollama Setup Guide](https://ollama-client.shishirchaurasiya.in/ollama-setup-guide)
122+
99123
More info: [https://ollama.com](https://ollama.com)
100124

101125
### ✅ 3. Pull a Model
@@ -200,6 +224,19 @@ pnpm package
200224

201225
### 🧪 6. Run, build and package in Firefox (Experimental)
202226

227+
**Setup Ollama for Firefox:**
228+
229+
Firefox requires manual CORS configuration. Use the helper script:
230+
231+
```bash
232+
# Cross-platform bash script (macOS/Linux/Windows with Git Bash)
233+
./tools/ollama-env.sh firefox
234+
```
235+
236+
This configures `OLLAMA_ORIGINS` for Firefox extension support.
237+
238+
**Build and run:**
239+
203240
```bash
204241
pnpm dev --target=firefox
205242
```
@@ -267,9 +304,7 @@ Ollama Client is a Chrome Manifest V3 extension. To use in Firefox:
267304

268305
## 🐛 Known Issues
269306

270-
- [ ] "Stop Generation" doesn’t always abort promptly
271307
- [ ] "Stop Pull" during model downloads may glitch
272-
- [ ] CORS is mostly handled via DNR, but may fail on older Chromium/Firefox versions or under certain network policies
273308
- [ ] Large chat histories in IndexedDB can impact performance
274309

275310
---

0 commit comments

Comments
 (0)