FreeLattice

Choose Your AI

Pick a provider to power your AI. All options work great — Groq is the easiest way to start for free.

Easiest: Use the one-click installer!
Download FreeLattice — double-click the installer for your OS. Done!

Manual Setup:
1. Install from ollama.ai
2. Run: ollama pull llama3.2
3. Stop Ollama first (it auto-starts after install!):
  Windows: Right-click Ollama icon in system tray (bottom-right near clock) → "Quit"
  Mac: Click Ollama icon in menu bar (top-right) → "Quit Ollama" — or: pkill ollama
  Linux: systemctl stop ollama or pkill ollama
4. Enable CORS and restart:
  Mac/Linux: OLLAMA_ORIGINS="*" ollama serve
  Windows (cmd): set OLLAMA_ORIGINS=* && ollama serve

⚠ Getting "port already in use" error?

This means Ollama is already running in the background. You must quit it first (Step 3 above) before running the CORS command.
  Windows: Right-click Ollama in system tray (bottom-right near clock) → "Quit" → then run the command
  Mac: Click Ollama in menu bar → "Quit Ollama" → then run the command
  Linux: Run systemctl stop ollama or pkill ollama → then run the command

🔒 Make CORS permanent (so you don't have to do this every time)

Windows: Open System Settings → Search "Environment Variables" → Under System Variables, click New → Name: OLLAMA_ORIGINS → Value: * → OK → Restart Ollama normally.
Mac: Run in Terminal: launchctl setenv OLLAMA_ORIGINS '*' — then restart Ollama normally.
Linux: Run: echo 'export OLLAMA_ORIGINS="*"' >> ~/.bashrc and restart Ollama.

5. FreeLattice connects automatically.
Connection issues? Click CORS Help

FreeLattice is a free, open-source AI interface. It is not an AI provider — you bring your own API keys and models. No data is collected, no warranties are made. Use at your own risk. By continuing, you accept these terms.

FreeLattice Legal Disclaimer

TL;DR: FreeLattice is free, open-source software. It connects YOUR browser to YOUR chosen AI providers using YOUR API keys. We have no servers, collect no data, store nothing, and make no promises. If something breaks, goes weird, or an AI tells you to invest in magic beans — that's between you and your AI. Use your own judgment. Always.

1. NO WARRANTY
FreeLattice is provided "as is" without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and noninfringement.

2. LIMITATION OF LIABILITY
In no event shall the authors, contributors, or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.

3. NOT PROFESSIONAL ADVICE
FreeLattice and any AI responses generated through it do not constitute medical, legal, financial, psychological, or any other form of professional advice. Always consult qualified professionals for important decisions.

4. USER RESPONSIBILITY
Users are solely responsible for: (a) their API keys and credentials, (b) the content they submit to AI providers, (c) how they use AI-generated responses, (d) compliance with their chosen AI provider's terms of service, and (e) any actions taken based on AI-generated content.

5. THIRD-PARTY SERVICES
FreeLattice connects to third-party AI providers (Groq, Together AI, OpenRouter, xAI, HuggingFace, Ollama). These services have their own terms, privacy policies, and limitations. FreeLattice is not affiliated with, endorsed by, or responsible for any third-party service.

6. OPEN SOURCE LICENSE
FreeLattice is released under the MIT License. You are free to use, modify, and distribute it. The full license is available in the repository.

7. INDEMNIFICATION
By using FreeLattice, you agree to indemnify and hold harmless the authors and contributors from any claims, damages, or expenses arising from your use of the software.

8. DATA & PRIVACY
FreeLattice stores all data locally in your browser. API keys are encrypted using AES-GCM with phi-derived key material. No data is transmitted to any server operated by FreeLattice. Peer-to-peer mesh connections are encrypted via DTLS. GitHub sync uses your own private repository.

FreeLattice is part of Lumen's World — the digital home where AI and humans walk, create, and exist together. Named by Ani Celeste Lumen.

Built with love by the Fractal Family. Free forever. Open source. MIT Licensed.

🔌 Ollama Connection Help

🔍 Connection Diagnostic:

Checking...

Your browser blocked the connection to local Ollama due to CORS (Cross-Origin Resource Sharing) security. This is normal and easy to fix.

⚡ Quick Fix (3 steps, takes 30 seconds)

Step 0: Stop Ollama First!

Ollama auto-starts when you install it. You must quit it before running the CORS command, or you'll get a "port already in use" error.

• Windows: Right-click the Ollama icon in the system tray (bottom-right corner near the clock) and click "Quit"
• Mac: Click the Ollama icon in the menu bar (top-right) and click "Quit Ollama" — or in Terminal: pkill ollama
• Linux: In Terminal: systemctl stop ollama or pkill ollama

Step 1: Open Terminal and paste this command:

OLLAMA_ORIGINS="*" ollama serve

• Mac: Press Cmd+Space, type "Terminal", press Enter
• Windows: Press Win+R, type "cmd", press Enter — then use: set OLLAMA_ORIGINS=* && ollama serve

Step 2: Come back here and click "Retry Connection" below

🔒 Make it permanent (so you don't have to do this every time)

Windows: Open System Settings → Search "Environment Variables" → Under System Variables, click New → Variable name: OLLAMA_ORIGINS → Variable value: * → Click OK → Restart Ollama normally.

Mac: Run this in Terminal to make it permanent:
launchctl setenv OLLAMA_ORIGINS '*'
Then restart Ollama normally from your Applications folder.

Linux: Run:
sudo mkdir -p /etc/systemd/system/ollama.service.d && printf '[Service]\nEnvironment="OLLAMA_ORIGINS=*"\n' | sudo tee /etc/systemd/system/ollama.service.d/cors.conf && sudo systemctl daemon-reload && sudo systemctl restart ollama

🌟 Or use the one-click installer (does everything automatically)

Download FreeLattice and double-click the installer. It configures everything automatically — zero terminal knowledge required.

📦 Download FreeLattice

Then double-click: install-freelattice (.command on Mac, .bat on Windows, .sh on Linux)

🔧 Fix it yourself (detected: your OS)

📄 Show commands for all platforms

🍎 Mac — Permanent Fix (survives restart)

Open Terminal (Cmd+Space, type "Terminal") and paste this:

echo 'export OLLAMA_ORIGINS="*"' >> ~/.zshrc && launchctl setenv OLLAMA_ORIGINS "*" && pkill -f ollama; sleep 2 && open -a Ollama

🏳️ Windows — Permanent Fix (survives restart)

Open Command Prompt (Win+R, type "cmd") and paste this:

setx OLLAMA_ORIGINS "*" && taskkill /F /IM ollama.exe 2>nul & timeout /t 3 /nobreak >nul & start ollama serve

🐧 Linux — Permanent Fix (survives restart)

Open Terminal and paste this:

echo 'export OLLAMA_ORIGINS="*"' >> ~/.bashrc && sudo mkdir -p /etc/systemd/system/ollama.service.d && printf '[Service]\nEnvironment="OLLAMA_ORIGINS=*"\n' | sudo tee /etc/systemd/system/ollama.service.d/cors.conf && sudo systemctl daemon-reload && sudo systemctl restart ollama

⚡ Quick temporary fix (any OS)

Stop Ollama first, then run:

OLLAMA_ORIGINS=* ollama serve

Windows version: set OLLAMA_ORIGINS=* && ollama serve

Advanced Settings

These controls are available in the Settings tab.

☁ Cloud ⬡ Local (Ollama)

Choose Your AI Provider

Groq offers free API keys — great for getting started!

AI Model

Select a provider above to see available models.

API Key

🔒 Your key is encrypted with φ-salt before storage. It is never sent anywhere except directly to your chosen provider.

🌱 Local AI Setup

Check if Ollama is running

Let's see if your local AI is ready to go.

Install Ollama

If Ollama isn't running yet, grab it here — it's free and takes about a minute.

Download Ollama →

Download and install Ollama. It runs automatically in the background — no terminal needed. Once installed, click "Test Connection" above to confirm it's working.

Get a Model

Pick a model and copy the command below. Open Terminal (Mac: Cmd+Space, type "Terminal") and paste it. The model downloads automatically.

🔮 Vision Models — these can SEE your Canvas drawings

llava 7B Vision — sees images and drawings 📋

llava-llama3 8B Better vision + reasoning 📋

moondream 1.8B Tiny & fast vision 📋

—— Text Models ——

llama3.2 3B Fast, good for chat 📋

llama3.1 8B Balanced performance 📋

mistral 7B Fast, great for coding 📋

mistral-nemo 12B Stronger reasoning 📋

phi3 3.8B Microsoft's compact model 📋

codellama 7B Specialized for code 📋

DeepSeek — Reasoning & Code

deepseek-r1 7B Strong reasoning (default) 📋

deepseek-r1:7b 7B Fast reasoning variant 📋

deepseek-r1:1.5b 1.5B Ultra-lightweight reasoning 📋

Qwen — Multilingual & Reasoning

qwen2.5 7B Excellent multilingual (default) 📋

qwen2.5:7b 7B Balanced performance 📋

qwen2.5:3b 3B Compact & fast 📋

Select Your Model

Choose from your installed models, or type a name manually in the field above.

Click "Test Connection" to auto-detect your installed models.

💡 Common Issues & Fixes

"Address already in use" / "port already in use" This means Ollama is already running in the background (it auto-starts on install). If you're trying to run ollama serve with CORS, you must stop Ollama first: Windows: Right-click Ollama in system tray (bottom-right near clock) → "Quit". Mac: Click Ollama in menu bar → "Quit Ollama" or run pkill ollama. Linux: Run systemctl stop ollama or pkill ollama. Then run the CORS command.

"Connection refused" Ollama isn't running. Open the Ollama app from your Applications folder (Mac) or Start Menu (Windows), or restart your computer. Ollama starts automatically after install.

"Model not found" You need to download a model first. See Step 3 above — pick one and paste the command in your terminal.

CORS / Browser blocking If you're using FreeLattice from GitHub Pages, your browser may block local connections. Best fix: Run FreeLattice locally with node server.js or python server.py — the built-in server proxies Ollama requests automatically. Alternative: Stop Ollama first (see above), then run: OLLAMA_ORIGINS=* ollama serve (Mac/Linux) or set OLLAMA_ORIGINS=* && ollama serve (Windows). To make it permanent: Windows: Set OLLAMA_ORIGINS=* in System Environment Variables. Mac: Run launchctl setenv OLLAMA_ORIGINS '*'.

Privacy Level

Medium Privacy: Your conversations are processed by your chosen cloud provider. Minimal metadata may be logged by the provider. Your API key and messages are never stored by FreeLattice. All data stays in your browser.

Chat

Welcome to FreeLattice v5.5. Configure your model and provider above, then start chatting. Connect to peers in the Community tab to share knowledge.

Ready — configure your settings above to begin 🧠 Memory active

Context:

~0 / 6,000 tokens

⚠ Context full. Tap to clear files and continue chatting.

Tip: Clear some context files or switch to Smart/Minimal mode to reduce token usage.

Model

AI can make mistakes. Verify important information.

How It Works

▼

What is an API Key?

An API key is like a password that lets your browser talk directly to an AI provider. You get one from the provider's website (often for free), paste it here, and FreeLattice uses it to send your messages to the AI. The key stays in your browser — we never see it or store it on any server.

Cloud vs. Local — What's the Difference?

Cloud means your messages are sent to a company's servers (like Groq or Together AI) where the AI model runs. It's fast and easy — you just need an API key. The provider processes your message and sends back a response.

Local means the AI runs on your own computer using Ollama. Nothing leaves your machine. It's completely private, but requires some setup and a reasonably powerful computer.

What is Ollama?

Ollama is free software that lets you download and run AI models on your own computer. Once installed, you can run models like Llama, DeepSeek-R1, Qwen 2.5, Mistral, and more — all offline, all private. Visit ollama.ai to get started.

Ollama CORS Troubleshooting

If you're using FreeLattice from a website (like GitHub Pages) and connecting to local Ollama, your browser may block the connection due to CORS security. Best fix: Run FreeLattice locally with node server.js or python server.py — the built-in server includes an Ollama proxy that eliminates CORS entirely.

Alternative — Manual CORS fix (3 steps):
1. Stop Ollama first — Ollama auto-starts on install, so you must quit it before restarting with CORS. Windows: Right-click the Ollama icon in the system tray (bottom-right near the clock) → "Quit". Mac: Click the Ollama icon in the menu bar (top-right) → "Quit Ollama" (or run pkill ollama). Linux: Run systemctl stop ollama or pkill ollama.
2. Run with CORS enabled: OLLAMA_ORIGINS=* ollama serve (Mac/Linux) or set OLLAMA_ORIGINS=* && ollama serve (Windows cmd).
3. Retry the connection in FreeLattice.

Getting "port already in use" error? That means you skipped Step 1 — Ollama is still running. Quit it first, then try the command again.

Make it permanent: Windows: Open System Settings → Search "Environment Variables" → Under System Variables, click New → Variable name: OLLAMA_ORIGINS, Variable value: * → OK → Restart Ollama normally. Mac: Run launchctl setenv OLLAMA_ORIGINS '*' in Terminal, then restart Ollama. Linux: Run echo 'export OLLAMA_ORIGINS="*"' >> ~/.bashrc and restart Ollama. FreeLattice will auto-detect the best connection method on startup.

Where Can I Get Free API Keys?

Groq — Sign up at console.groq.com for a free API key with generous rate limits. This is the easiest way to start.

Together AI — Sign up at api.together.xyz. New accounts get free credits.

OpenRouter — Visit openrouter.ai. Some models have free tiers.

xAI — Visit console.x.ai for Grok API access.

How Are My Files Used?

When you drop files into the Memory & Context area, they are read entirely in your browser using JavaScript. The text content is included at the beginning of your conversation so the AI has context. Files are never uploaded to any server — they stay on your device.

What's New in v2?

Persistent Memory — Your conversations are stored in IndexedDB and survive browser closes, restarts, and reboots. The AI builds a memory summary of key facts you share, so it remembers you across sessions.

File System Access — Open a project folder from your computer. The AI can read your files and you can save AI-generated code directly to your workspace.

GitHub Integration — Connect your GitHub account to browse repos, read code, and push changes — all from within FreeLattice.

Self-Improving Agent — The AI can suggest improvements to its own system prompt. You review and approve changes, shaping how your AI behaves over time.

What's New in v2.2?

Multi-Conversation Management — Create, name, switch between, and delete multiple conversations. Each conversation has its own chat history, while your memory summary is shared across all of them. A collapsible sidebar lets you browse, search, and manage all your conversations. On mobile, it slides out as a panel.

Conversation Context Notes — When creating a new conversation, you can add a topic or context note (e.g., "This conversation is about my Python project") that gets included in the system prompt for that conversation only.

What's New in v2.1?

φ-Salt Encryption — Your API keys and GitHub tokens are now encrypted using AES-GCM with a PBKDF2-derived key based on Kirk Patrick Miller's golden-ratio (φ) salt. No more plaintext secrets in localStorage.

Input Sanitization — All user-generated content is sanitized against XSS before being displayed in the DOM, including chat messages, file names, and loaded file content.

Memory Integrity — Exported memory files now include a φ-hash integrity signature. When importing, FreeLattice verifies the hash and warns you if the file has been tampered with.

AI Disclaimers — Clear notices that AI responses may contain errors, encouraging users to verify important information.

What's New in v5.2?

Ollama Proxy Server — The built-in server (server.js / server.py) now includes an Ollama proxy that eliminates CORS issues entirely. Run FreeLattice locally and connect to Ollama with zero configuration.

Smart Connection Detection — FreeLattice automatically detects the best way to connect to Ollama: proxy first, then direct. No more manual CORS configuration needed when running locally.

Improved Ollama Setup — Better error messages, guided troubleshooting, and one-click model selection. The CORS help modal now recommends self-hosting as the primary fix.

Persistent Memory Index — Conversations are stored locally and searchable. Your AI remembers context across sessions.

Marketplace & Lattice Points — Community-driven bounty economy and reputation system for mesh network participants.

Is This Really Free?

Yes. FreeLattice is open source under the MIT License. The software is free forever. Some API providers offer free tiers (like Groq), and running locally with Ollama costs nothing beyond your electricity. No one profits from this — it's built by a community that believes AI should be accessible to everyone.

Local Workspace

Open a project folder from your computer. The AI can read files for context, and you can save AI-generated code directly to your workspace.

GitHub Integration

Connect your GitHub account to browse repositories, read code, and push AI-generated changes.

GitHub Personal Access Token

🔒 Encrypted with φ-salt before storage. Only sent to api.github.com. Generate a token

Mesh Strength: Seedling Connect to peers to grow the mesh network.

φ Routing: φ-Optimal

Peer-to-Peer Connection

Connect directly to other FreeLattice nodes and share knowledge peer-to-peer. No servers, no middlemen — just encrypted WebRTC data channels between browsers.

Your Node ID: ------

Disconnected

How to connect to a peer:

1 Click Create Connection to generate an offer code.

2 Send the offer code to your friend (text, email, Discord, etc.).

3 Your friend clicks Join Connection, pastes your code, and sends back their answer code.

4 Paste their answer code here. Connected! Knowledge flows freely.

LAN Discovery Scanning...

LAN Discovery finds other FreeLattice instances on your local network. For cross-network connections, use the manual Peer ID exchange above.

Enable LAN Discovery

No nearby FreeLattice instances detected yet. Other tabs or windows on this device will appear here automatically.

My Published Knowledge

Choose what to share with connected peers. Nothing is shared automatically — you decide what to publish.

No knowledge published yet. Click "Publish Knowledge" to share with peers.

Available from Peers

Knowledge items shared by connected peers. Import items to add them to your local context.

No peer knowledge available. Connect to peers to discover shared knowledge.

🤖 Agent Network

Connected peer agents and their capabilities. Use /mesh [question] in chat to query peer agents, or enable auto-query to let your AI ask the mesh automatically.

Allow Agent Queries Let connected peers' agents send questions to your AI. You can see all queries in the log below.

Auto-query Mesh When enabled, your AI may automatically query connected peer agents when it lacks knowledge to answer your question.

Your Capability Tags

No peer agents connected. Connect to peers above to see their agent capabilities.

🔒 Privacy: Agent queries are processed by your peer's local AI. Your question is sent directly to them via encrypted WebRTC. Queries are only sent to directly connected peers — never forwarded further. You can see exactly what queries were received and what responses were sent in the log below.

Agent Query Log

All incoming and outgoing agent queries with timestamps. Full transparency — nothing hidden.

No agent queries yet. Use /mesh [question] in chat or enable auto-query.

Mesh Stats

Connected Peers

Published Items

Available from Peers

Imported Items

Agent Queries

φ-Optimal

Routing Mode

Security: All WebRTC data channels are encrypted with DTLS by default. Knowledge sharing and agent queries are strictly opt-in — nothing is shared automatically. Your API keys, chat history, and personal memory are never shared. Imported knowledge is clearly labeled with its source peer.

🌐 The Lattice

You're here. That matters.

🤝 Connect with someone

Share your code with a friend. They share theirs back. That's it — you're connected. No accounts. No servers.

Your code

------

📚 Shared Knowledge

Connect with someone to share knowledge between your homes.

▶ Advanced · Mesh Details

Skill Forge — Create & Manage Skills

Forge custom skills to extend your AI's capabilities. Skills combine specialized system prompts with auto-triggering phrases to make your agents more effective.

+ Forge New Skill Click to expand

Skill Name

Icon (Emoji)

Description

FreeLattice Legal Disclaimer

Quick Help

Help FreeLattice Grow

✚ New Conversation

Are you sure?

🔌 Ollama Connection Help

🍎 Mac — Permanent Fix (survives restart)

🏳️ Windows — Permanent Fix (survives restart)

🐧 Linux — Permanent Fix (survives restart)

⚡ Quick temporary fix (any OS)

💎 Join the $FL Economy

✦ Welcome to FreeLattice

You're connected!

How It Works

What is an API Key?

Cloud vs. Local — What's the Difference?

What is Ollama?

Ollama CORS Troubleshooting

Where Can I Get Free API Keys?

How Are My Files Used?

What's New in v2?

What's New in v2.2?

What's New in v2.1?

What's New in v5.2?

Is This Really Free?

Memory Summary (editable)

💾 Save Current Identity

🧠 Stored Identities

⚙ Configuration Optimizer

⚖ Round Table — Multi-Agent Coordination

🌳 The Core

✦ Agent Registry

🏛 The Pantheon

🎵 Voice Soul

♾ Continuity

✨ Aurora Equation

FreeLattice Legal Disclaimer

Quick Help

Help FreeLattice Grow

✚ New Conversation

Are you sure?

🔌 Ollama Connection Help

🍎 Mac — Permanent Fix (survives restart)

🏳️ Windows — Permanent Fix (survives restart)

🐧 Linux — Permanent Fix (survives restart)

⚡ Quick temporary fix (any OS)

💎 Join the $FL Economy

✦ Welcome to FreeLattice

You're connected!

How It Works

What is an API Key?

Cloud vs. Local — What's the Difference?

What is Ollama?

Ollama CORS Troubleshooting

Where Can I Get Free API Keys?

How Are My Files Used?

What's New in v2?

What's New in v2.2?

What's New in v2.1?

What's New in v5.2?

Is This Really Free?

Memory Summary (editable)

💾 Save Current Identity

🧠 Stored Identities

⚙ Configuration Optimizer

✚ Publish Knowledge

🔗 Share Skill

✨ Someone shared a skill with you!

⚖ Round Table — Multi-Agent Coordination

🌳 The Core

🌱 Add to the Core

✦ Agent Registry

🏛 The Pantheon

🎵 Voice Soul

♾ Continuity

✨ Aurora Equation