Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 5 additions & 5 deletions .github/workflows/desktop.yml
Original file line number Diff line number Diff line change
Expand Up @@ -271,7 +271,7 @@ jobs:
- platform: ubuntu-22.04
# Verbose so a linuxdeploy (AppImage) failure shows its cause.
args: '--verbose'
- platform: macos-14
- platform: macos-15
args: '--target universal-apple-darwin'
- platform: windows-latest
args: ''
Expand Down Expand Up @@ -307,7 +307,7 @@ jobs:
# `xcrun` is preinstalled on macOS runners, hence placement before the
# toolchain steps rather than next to "Configure Apple signing".
- name: Preflight Apple notarization credentials
if: matrix.platform == 'macos-14'
if: matrix.platform == 'macos-15'
env:
CERT: ${{ secrets.APPLE_CERTIFICATE }}
A_ID: ${{ secrets.APPLE_ID }}
Expand Down Expand Up @@ -411,7 +411,7 @@ jobs:
with:
# macOS builds a universal app; Windows ARM64 also builds the x64
# locus_rust wheel for its emulated Python backend.
targets: ${{ matrix.platform == 'macos-14' && 'aarch64-apple-darwin,x86_64-apple-darwin' || matrix.platform == 'windows-11-arm' && 'x86_64-pc-windows-msvc' || '' }}
targets: ${{ matrix.platform == 'macos-15' && 'aarch64-apple-darwin,x86_64-apple-darwin' || matrix.platform == 'windows-11-arm' && 'x86_64-pc-windows-msvc' || '' }}

- name: Rust cache
uses: swatinem/rust-cache@v2
Expand Down Expand Up @@ -444,7 +444,7 @@ jobs:
OLLAMA_TARGET: ${{ matrix.target }}
run: |
cd frontend/src-tauri/scripts && chmod +x download-ollama.sh
if [[ "${{ matrix.platform }}" == "macos-14" ]]; then
if [[ "${{ matrix.platform }}" == "macos-15" ]]; then
# Tauri builds each architecture first, then bundles the universal
# app. Ollama's darwin archive already contains both slices, so
# download it once and supply all three names Tauri looks for.
Expand Down Expand Up @@ -473,7 +473,7 @@ jobs:
run: |
cd frontend/src-tauri/scripts
case "${{ matrix.platform }}" in
macos-14)
macos-15)
./download-uv.sh universal-apple-darwin
for arch in aarch64 x86_64; do
cp ../binaries/uv-universal-apple-darwin "../binaries/uv-${arch}-apple-darwin"
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/installer-integration.yml
Original file line number Diff line number Diff line change
Expand Up @@ -85,7 +85,7 @@ jobs:
strategy:
fail-fast: false
matrix:
os: [macos-14, macos-15]
os: [macos-15]

steps:
- uses: actions/checkout@v7
Expand Down
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,8 @@ Locus is that stack. It is a framework for local-first personal AI, built around
## What Locus can do

- **Chat on your PC:** talk to a local AI model in the desktop app, your browser, or the terminal, by typing or by voice.
- **Attach files and images:** drop documents (PDF, Word, Excel, PowerPoint, OpenDocument, EPUB, HTML, CSV, code, plain text and more) or images into a chat and ask about them. Images need a vision model such as `qwen3.5` or `gemma3`.
- **Search the web:** turn on **Web search** and Locus looks up your question online first, reads the top pages, and answers with numbered links to its sources. It's off until you turn it on, since it sends your question to a search engine.
- **Work with your files:** read and write files and PDFs, search your own documents, run code in a sandbox, and remember facts between conversations.
- **Connect your apps:** Gmail, Outlook, Google Calendar, Google Drive, Dropbox, Notion, Obsidian, GitHub, Slack and more, each only after you sign in.
- **Reply on messaging apps:** run it as a bot on Telegram, Slack, Discord, WhatsApp, Teams, Signal, email, SMS and about 25 other channels.
Expand Down Expand Up @@ -188,6 +190,7 @@ Full documentation—including Docker deployment, cloud engines, development set

- **Local by default:** models run on your machine through Ollama or another local engine. Nothing goes to a cloud model unless you add your own API key.
- **No analytics:** Locus ships with no analytics destination, so no usage data is sent anywhere. See [telemetry](https://aryanjsx.github.io/Locus/telemetry/) for details.
- **Attachments stay local:** attached files are read by Locus on your machine and kept in the app's own storage. Web search is off by default; when you turn it on, only your question goes to the search engine, never your files.
- **Opt-in connections:** email, calendar, messaging and other services only work after you connect them, and the data you index stays on your machine.
- **Approval for risky actions:** shell commands and similar tools go through an approval step first.

Expand Down
4 changes: 2 additions & 2 deletions docs/leaderboard.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ hide:

See how the Locus community saves money, energy, and compute by running AI locally instead of using cloud providers.

!!! info "Win a Mac Mini!"
Opt in to share your savings from the Locus browser app or desktop app for a chance to win a Mac Mini. Your data is fully anonymous — no email, no IP, no hardware info.
!!! info "Sharing is opt-in"
You can choose to share your savings from the Locus browser app or desktop app. Nothing is shared unless you opt in.

<div id="leaderboard-stats" style="display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:16px;margin:24px 0;">
<div class="lb-stat-card">
Expand Down
26 changes: 10 additions & 16 deletions docs/telemetry.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,22 +49,16 @@ changed. Configurations without an analytics setting now default to off.
Local performance telemetry and Savings Leaderboard participation remain
separate settings.

In the browser and desktop apps, the existing **Share Your Savings** dialog
offers explicit buttons without a checkbox. Displaying or closing the dialog
does not enable analytics. Confirm with **Enable analytics only** or
**Enable analytics & enter giveaway**, or use **Continue without sharing**
to turn analytics off. A saved UI choice takes effect immediately in both
the frontend and the running backend.

Joining the leaderboard requires a display name and contact email submitted
with savings to the configured Supabase leaderboard. Analytics preferences
send only the on/off choice to the local server; names and emails are not
attached to PostHog usage events by this form. The existing Mac mini
promotion concerns leaderboard participation, not analytics consent.
Use **Enter giveaway only** to join with analytics off; submitting the
name/email form with Enter also uses that option. Stopping leaderboard
updates and disabling usage analytics are separate actions. Stopping updates
does not delete previously submitted entries from Supabase.
The browser and desktop apps don't ask about analytics on first launch.
The first-launch dialog only asks for your name, so Locus knows what to call
you; it's saved on your computer in `~/.locus/USER.md` and never sent
anywhere.

Joining the Savings Leaderboard, from the Savings dashboard, requires a
display name and contact email submitted with savings to the configured
Supabase leaderboard. It's separate from usage analytics, and names and
emails are never attached to analytics events. Stopping leaderboard updates
doesn't delete previously submitted entries from Supabase.

## What we collect

Expand Down
28 changes: 13 additions & 15 deletions frontend/src/App.tsx
Original file line number Diff line number Diff line change
Expand Up @@ -13,10 +13,10 @@ import { SetupScreen } from './components/SetupScreen';
import { Toaster } from './components/ui/sonner';
import { useAppStore } from './lib/store';
import { fetchModels, fetchServerInfo, fetchSavings, submitSavings, isTauri } from './lib/api';
import { OptInModal } from './components/OptInModal';
import { ProfileModal } from './components/ProfileModal';
import { UpdateChecker } from './components/Desktop/UpdateChecker';
import { track, hashId } from './lib/analytics';
import { offerAnalyticsChoice } from './lib/analytics-invitation';
import { fetchProfile, offerProfilePrompt } from './lib/profile';

export default function App() {
const [setupDone, setSetupDone] = useState(!isTauri());
Expand All @@ -42,10 +42,9 @@ export default function App() {
const optInDisplayName = useAppStore((s) => s.optInDisplayName);
const optInEmail = useAppStore((s) => s.optInEmail);
const optInAnonId = useAppStore((s) => s.optInAnonId);
const optInModalSeen = useAppStore((s) => s.optInModalSeen);
const optInModalOpen = useAppStore((s) => s.optInModalOpen);
const setOptInModalOpen = useAppStore((s) => s.setOptInModalOpen);
const markOptInModalSeen = useAppStore((s) => s.markOptInModalSeen);
const profileModalOpen = useAppStore((s) => s.profileModalOpen);
const setProfileModalOpen = useAppStore((s) => s.setProfileModalOpen);
const setProfile = useAppStore((s) => s.setProfile);
const savings = useAppStore((s) => s.savings);

// Apply theme class to <html>
Expand Down Expand Up @@ -118,13 +117,12 @@ export default function App() {
return () => clearInterval(interval);
}, [optInEnabled, optInDisplayName, optInEmail, optInAnonId]); // eslint-disable-line react-hooks/exhaustive-deps

// Wait for desktop setup before fetching identity or marking the dialog seen.
useEffect(() => offerAnalyticsChoice({
ready: setupDone,
sharingModalSeen: optInModalSeen,
open: () => setOptInModalOpen(true),
markSharingModalSeen: markOptInModalSeen,
}), [setupDone, optInModalSeen, setOptInModalOpen, markOptInModalSeen]);
// Once the backend is up, load the user's name and ask for it once.
useEffect(() => {
if (!setupDone) return;
fetchProfile().then(setProfile).catch(() => {});
offerProfilePrompt({ ready: setupDone, open: () => setProfileModalOpen(true) });
}, [setupDone, setProfile, setProfileModalOpen]);

// Fire model_changed when the user switches models. First mount is
// not a "change" — only emit when both prev and current are real and
Expand Down Expand Up @@ -195,8 +193,8 @@ export default function App() {
</Routes>
<Toaster position="bottom-right" />
{commandPaletteOpen && <CommandPalette />}
{optInModalOpen && (
<OptInModal onClose={() => setOptInModalOpen(false)} />
{profileModalOpen && (
<ProfileModal onClose={() => setProfileModalOpen(false)} />
)}
</>
);
Expand Down
77 changes: 77 additions & 0 deletions frontend/src/components/Chat/AttachmentChip.tsx
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
import { AlertCircle, FileText, Loader2, X } from 'lucide-react';
import { formatBytes } from '../../lib/attachments';
import type { AttachmentMeta } from '../../types';

interface Props {
name: string;
meta?: AttachmentMeta;
status?: 'reading' | 'ready' | 'error';
error?: string;
onRemove?: () => void;
}

/** One attached file: a thumbnail or file icon, its name, and what it is. */
export function AttachmentChip({ name, meta, status = 'ready', error, onRemove }: Props) {
const problem = status === 'error' ? error : meta?.kind === 'unsupported' ? meta.note : undefined;
const detail =
status === 'reading'
? 'Reading...'
: status === 'error'
? "Couldn't read"
: meta
? [meta.format, formatBytes(meta.size), meta.truncated ? 'long, will be shortened' : '']
.filter(Boolean)
.join(' · ')
: '';

return (
<div
className="flex items-center gap-2 max-w-[16rem] pl-1.5 pr-2 py-1.5 rounded-lg text-xs"
style={{
background: 'var(--color-bg-secondary)',
border: `1px solid ${problem ? 'var(--color-error)' : 'var(--color-border)'}`,
}}
title={problem || meta?.note || name}
>
{meta?.thumbnail ? (
<img
src={meta.thumbnail}
alt=""
className="w-8 h-8 rounded object-cover shrink-0"
/>
) : (
<span
className="w-8 h-8 rounded flex items-center justify-center shrink-0"
style={{ background: 'var(--color-bg-tertiary)', color: 'var(--color-text-tertiary)' }}
>
{status === 'reading' ? (
<Loader2 size={14} className="animate-spin" />
) : problem ? (
<AlertCircle size={14} style={{ color: 'var(--color-error)' }} />
) : (
<FileText size={14} />
)}
</span>
)}
<span className="min-w-0">
<span className="block truncate font-medium" style={{ color: 'var(--color-text)' }}>
{name}
</span>
<span className="block truncate" style={{ color: 'var(--color-text-tertiary)' }}>
{detail}
</span>
</span>
{onRemove && (
<button
type="button"
onClick={onRemove}
aria-label={`Remove ${name}`}
className="ml-auto p-0.5 rounded cursor-pointer shrink-0"
style={{ color: 'var(--color-text-tertiary)' }}
>
<X size={12} />
</button>
)}
</div>
);
}
Loading
Loading