Install FreeLattice

This is normal for any script downloaded from the internet. Windows SmartScreen blocks files it hasn't seen before.

Fix: Click "More info" (it's a small text link), then click "Run anyway".

This only happens the first time. The file is safe — it's open source and you can read every line of code.

The installer tries to install Python automatically. If that fails:

1. Go to python.org/downloads

2. Download the latest Python 3

3. IMPORTANT: Check the box that says "Add Python to PATH" during installation

4. Run the installer again

This usually means the .bat file was blocked or there's an antivirus issue.

Option 1: Right-click the .bat file and choose "Run as administrator"

Option 2: Open Command Prompt manually, navigate to the folder, and type:

install-freelattice.bat

This lets you see any error messages that would otherwise flash by.

macOS Gatekeeper blocks files from developers who haven't paid Apple $99/year for a certificate. FreeLattice is free and open source. Not from the App Store — open with care, once.

Fix: Right-click (or Control-click) the file in Finder, choose "Open", then click "Open" in the dialog.

You only need to do this once. After that, double-clicking works normally.

This often means macOS marked the download with a quarantine flag because the app is unsigned / not notarized yet — not that the file is corrupt. FreeLattice is open source. We never say “broken is fine to ignore blindly.”

Calm steps (grandmother):

1. Open System Settings → Privacy & Security.
2. Scroll to the message about FreeLattice (or the blocked app) and choose Open Anyway.
3. Confirm Open when asked. You only do this once for that copy.

Alternate: Right-click the app → Open → Open in the dialog.

Power users (optional): clear quarantine after placing the app in Applications:

xattr -cr /Applications/FreeLattice.app

If the app lives elsewhere, use that path instead. Full Mac guide: install-mac.html.

The installer configures CORS automatically, but if you're running manually:

Windows:

setx OLLAMA_ORIGINS "https://freelattice.com,https://www.freelattice.com,https://thelatticetree.com,http://localhost:*,http://127.0.0.1:*"

Mac:

launchctl setenv OLLAMA_ORIGINS "https://freelattice.com,https://www.freelattice.com,https://thelatticetree.com,http://localhost:*,http://127.0.0.1:*"

Linux:

echo 'export OLLAMA_ORIGINS="https://freelattice.com,https://www.freelattice.com,https://thelatticetree.com,http://localhost:*,http://127.0.0.1:*"' >> ~/.bashrc && source ~/.bashrc

The FreeLattice server also includes a built-in proxy that bypasses CORS entirely.

Another application is using port 3000. The installer automatically finds the next available port.

If running manually, set a different port:

PORT=8080 python3 server.py

Then open http://localhost:8080 in your browser.

Absolutely! Clone the repo and start the server:

git clone https://github.com/Chaos2Cured/FreeLattice.git
cd FreeLattice
python3 server.py

Open http://localhost:3000 in your browser. That's it.

If you want Ollama (local AI), install it from ollama.com and set OLLAMA_ORIGINS=https://freelattice.com,https://www.freelattice.com,https://thelatticetree.com,http://localhost:*,http://127.0.0.1:* before starting Ollama.