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
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/bug_report.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ body:
label: Steps to Reproduce
description: Steps to reproduce the behavior.
placeholder: |
1. Run `jarvis ask "..."`
1. Run `locus ask "..."`
2. See error...
validations:
required: true
Expand Down
2 changes: 1 addition & 1 deletion .github/ISSUE_TEMPLATE/config.yml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
blank_issues_enabled: false
contact_links:
- name: Ask a Question
url: https://github.com/locus/Locus/discussions
url: https://github.com/aryanjsx/Locus/discussions
about: Use Discussions for questions and help
14 changes: 7 additions & 7 deletions .github/ISSUE_TEMPLATE/pearl_model_validation.yml
Original file line number Diff line number Diff line change
Expand Up @@ -70,15 +70,15 @@ body:
required: true
- label: Non-mining layers use int8 vanilla Pearl GEMM
required: true
- label: `jarvis mine init --model <pearl-model-id>` succeeds
- label: `locus mine init --model <pearl-model-id>` succeeds
required: true
- label: `jarvis mine start` succeeds
- label: `locus mine start` succeeds
required: true
- label: `jarvis ask` succeeds through the mining engine
- label: `locus ask` succeeds through the mining engine
required: true
- label: `jarvis mine status` reports gateway/mining metrics
- label: `locus mine status` reports gateway/mining metrics
required: true
- label: `jarvis mine validate-model --allow-planned` passes
- label: `locus mine validate-model --allow-planned` passes
required: true
- label: Gateway/miner logs show no submission errors
required: true
Expand All @@ -89,8 +89,8 @@ body:
description: Attach logs, metrics, model config, and command output.
placeholder: |
- /v1/models output:
- `jarvis mine status` output:
- `jarvis mine validate-model --output` JSON:
- `locus mine status` output:
- `locus mine validate-model --output` JSON:
- gateway metrics excerpt:
- miner logs:
- PR/commit that flips status to validated:
Expand Down
2 changes: 1 addition & 1 deletion .github/workflows/bash-tests.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,5 +25,5 @@ jobs:

- name: Run bats tests
env:
Locus_TEST_PYTHON: /usr/bin/python3
LOCUS_TEST_PYTHON: /usr/bin/python3
run: bats tests/install/bash/
2 changes: 1 addition & 1 deletion .github/workflows/ci.yml
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@ jobs:
- name: Smoke-test CLI
shell: bash
run: |
uv run jarvis --version
uv run locus --version

rust:
runs-on: ubuntu-latest
Expand Down
7 changes: 4 additions & 3 deletions .github/workflows/desktop.yml
Original file line number Diff line number Diff line change
Expand Up @@ -80,7 +80,7 @@ jobs:
run: |
uv sync --locked --extra dev --extra desktop --extra inference-cloud --extra inference-google --group desktop-native
uv run python -c "import sysconfig, locus_rust; assert sysconfig.get_platform() == 'win-amd64'; print('x64 backend and Rust extension import OK')"
uv run jarvis --version
uv run locus --version
uv run pytest tests/hardware/test_hardware_profiles.py tests/core/test_utils.py -q

- name: Download ARM64 Ollama and stage test bundle
Expand Down Expand Up @@ -541,8 +541,9 @@ jobs:
TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
# tauri-action runs beforeBuildCommand (npm run build:tauri -> vite
# build), which requires this at build time (#587). Strict for
# releases: a missing/empty secret fails the build by design.
# build). The leaderboard is enabled only when both the URL and the
# anon key are set (see src/lib/supabase.ts).
VITE_SUPABASE_URL: ${{ vars.VITE_SUPABASE_URL }}
VITE_SUPABASE_ANON_KEY: ${{ secrets.VITE_SUPABASE_ANON_KEY }}
with:
projectPath: frontend
Expand Down
11 changes: 7 additions & 4 deletions .github/workflows/docs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,15 +47,18 @@ jobs:
# and JSON-encoded into a JS string literal to avoid any injection.
- name: Inject leaderboard Supabase anon key
env:
Locus_LEADERBOARD_ANON: ${{ secrets.VITE_SUPABASE_ANON_KEY }}
LOCUS_LEADERBOARD_URL: ${{ vars.VITE_SUPABASE_URL }}
LOCUS_LEADERBOARD_ANON: ${{ secrets.VITE_SUPABASE_ANON_KEY }}
run: |
python3 - <<'PY'
import json, os, pathlib

key = os.environ.get("Locus_LEADERBOARD_ANON", "")
url = os.environ.get("LOCUS_LEADERBOARD_URL", "")
key = os.environ.get("LOCUS_LEADERBOARD_ANON", "")
pathlib.Path("docs/javascripts/leaderboard-config.js").write_text(
"// Generated at docs-build time from the VITE_SUPABASE_ANON_KEY secret.\n"
"window.Locus_SUPABASE_ANON_KEY = " + json.dumps(key) + ";\n",
"// Generated at docs-build time from VITE_SUPABASE_URL and VITE_SUPABASE_ANON_KEY.\n"
"window.LOCUS_SUPABASE_URL = " + json.dumps(url) + ";\n"
"window.LOCUS_SUPABASE_ANON_KEY = " + json.dumps(key) + ";\n",
encoding="utf-8",
)
print("leaderboard anon key:", "set" if key else "empty (leaderboard disabled)")
Expand Down
1 change: 1 addition & 0 deletions .github/workflows/frontend.yml
Original file line number Diff line number Diff line change
Expand Up @@ -47,4 +47,5 @@ jobs:
# Optional: when the secret is unset the build still succeeds and the
# leaderboard is disabled (see src/lib/supabase.ts). No placeholder,
# so a keyless CI build doesn't bake in a bogus anon key.
VITE_SUPABASE_URL: ${{ vars.VITE_SUPABASE_URL }}
VITE_SUPABASE_ANON_KEY: ${{ secrets.VITE_SUPABASE_ANON_KEY }}
32 changes: 16 additions & 16 deletions .github/workflows/installer-integration.yml
Original file line number Diff line number Diff line change
Expand Up @@ -50,7 +50,7 @@ jobs:
run: |
chown -R testuser:testuser /home/testuser "$GITHUB_WORKSPACE/locus-src"
su testuser -c '
export Locus_REPO_URL=file://'"$GITHUB_WORKSPACE"'/locus-src
export LOCUS_REPO_URL=file://'"$GITHUB_WORKSPACE"'/locus-src
cd '"$GITHUB_WORKSPACE"'/locus-src
bash scripts/install/install.sh --no-bg-orchestrator
'
Expand All @@ -62,21 +62,21 @@ jobs:
test -d ~/.locus/.venv
test -f ~/.locus/config.toml
test -f ~/.locus/.state/install-state.json
test -L ~/.local/bin/jarvis
test -L ~/.local/bin/locus
'

- name: Verify jarvis --version
run: su testuser -c '~/.local/bin/jarvis --version'
- name: Verify locus --version
run: su testuser -c '~/.local/bin/locus --version'

- name: Verify jarvis doctor exits 0
run: su testuser -c '~/.local/bin/jarvis doctor'
- name: Verify locus doctor exits 0
run: su testuser -c '~/.local/bin/locus doctor'

- name: Verify uninstall is clean
run: |
su testuser -c '
~/.local/bin/jarvis-uninstall --yes
~/.local/bin/locus-uninstall --yes
test ! -d ~/.locus
test ! -L ~/.local/bin/jarvis
test ! -L ~/.local/bin/locus
'

macos:
Expand All @@ -95,24 +95,24 @@ jobs:

- name: Run installer
run: |
export Locus_REPO_URL=file://$(pwd)
export LOCUS_REPO_URL=file://$(pwd)
bash scripts/install/install.sh --no-bg-orchestrator

- name: Verify install state
run: |
test -d ~/.locus/src
test -d ~/.locus/.venv
test -f ~/.locus/config.toml
test -L ~/.local/bin/jarvis
test -L ~/.local/bin/locus

- name: Verify jarvis --version
run: ~/.local/bin/jarvis --version
- name: Verify locus --version
run: ~/.local/bin/locus --version

- name: Verify jarvis doctor exits 0
run: ~/.local/bin/jarvis doctor
- name: Verify locus doctor exits 0
run: ~/.local/bin/locus doctor

- name: Verify uninstall is clean
run: |
~/.local/bin/jarvis-uninstall --yes
~/.local/bin/locus-uninstall --yes
test ! -d ~/.locus
test ! -L ~/.local/bin/jarvis
test ! -L ~/.local/bin/locus
1 change: 1 addition & 0 deletions .github/workflows/pypi-publish.yml
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,7 @@ jobs:

- name: Build frontend and bundle into package
env:
VITE_SUPABASE_URL: ${{ vars.VITE_SUPABASE_URL }}
VITE_SUPABASE_ANON_KEY: ${{ secrets.VITE_SUPABASE_ANON_KEY }}
run: |
set -euo pipefail
Expand Down
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -117,7 +117,7 @@ scratch/
# ---------------------------------------------------------------------------
# Distillation runtime artifacts (defense in depth — these should always live
# in ~/.locus/, never inside the source tree, but we ignore them here in
# case Locus_HOME is misconfigured during dev)
# case LOCUS_HOME is misconfigured during dev)
# ---------------------------------------------------------------------------
.locus/
learning.db
Expand Down
8 changes: 4 additions & 4 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -170,7 +170,7 @@ logic is covered by unit tests.
handshake failure` (the domain is community-operated and had a broken
TLS config). The canonical installer is now served from the
project-controlled GitHub Pages site at
`https://locus.github.io/Locus/install.sh`, generated from
`https://aryanjsx.github.io/Locus/install.sh`, generated from
the same `scripts/install/install.sh` at docs-build time. The README
also documents the WSL2 path for Windows and the `uv` prerequisite
for the desktop binary, and the installer bails early with a clear
Expand Down Expand Up @@ -214,9 +214,9 @@ installed desktop app would never check. Both are now fixed; the app
polls `releases/download/desktop-latest/latest.json` every 30 minutes
and signature-verifies downloads against the minisign pubkey baked
into the app. Full flow, key-rotation runbook, and dev escape hatch
(`Locus_NO_UPDATER=1`) documented in `docs/desktop-auto-update.md`.
(`LOCUS_NO_UPDATER=1`) documented in `docs/desktop-auto-update.md`.

**Analytics env-var opt-out** (`DO_NOT_TRACK`, `Locus_NO_ANALYTICS`).
**Analytics env-var opt-out** (`DO_NOT_TRACK`, `LOCUS_NO_ANALYTICS`).
Tanvir's analytics module (#351) only respected the
`[analytics] enabled` config-file setting. Both env vars are now
honored in `is_analytics_enabled()` and in the install.sh beacon
Expand Down Expand Up @@ -259,7 +259,7 @@ The five-primitive architecture (Intelligence, Engine, Agents,
Tools & Memory, Learning) is now stable, with efficiency and
on-device learning as first-class capabilities alongside accuracy.
Companion blog post:
[From Minions to Locus: A Retrospective on Two Years in Local AI](https://hazyresearch.stanford.edu/blog/2026-05-19-minions-to-locus-retrospective).
[From Minions to OpenJarvis: A Retrospective on Two Years in Local AI](https://hazyresearch.stanford.edu/blog/2026-05-19-minions-to-openjarvis-retrospective).

### Highlights

Expand Down
2 changes: 1 addition & 1 deletion CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
Expand Up @@ -37,7 +37,7 @@ This Code of Conduct applies within all community spaces, and also applies when

## Enforcement

Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [the project maintainers](https://github.com/locus/Locus/discussions). All complaints will be reviewed and investigated promptly and fairly.
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at [the project maintainers](https://github.com/aryanjsx/Locus/discussions). All complaints will be reviewed and investigated promptly and fairly.

All community leaders are obligated to respect the privacy and security of the reporter of any incident.

Expand Down
16 changes: 8 additions & 8 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ All contributors with merged pull requests will be acknowledged as contributors

We're giving away a Mac Mini to one lucky contributor! Install Locus on your personal machine and opt in via the desktop app to share anonymized savings data (FLOPs, dollar cost, energy) for a chance to win. Your data is fully anonymous — no IP, no hardware info beyond savings metrics. You must share your email via the desktop app to be eligible.

See the [Savings Leaderboard](https://locus.github.io/Locus/leaderboard/) for details.
See the [Savings Leaderboard](https://aryanjsx.github.io/Locus/leaderboard/) for details.

### Path to Maintainership

Expand All @@ -43,7 +43,7 @@ These are great starting points for new contributors:
- New eval datasets and scorers
- Test coverage improvements

Look for issues labeled [`good-first-issue`](https://github.com/locus/Locus/labels/good-first-issue).
Look for issues labeled [`good-first-issue`](https://github.com/aryanjsx/Locus/labels/good-first-issue).

### Ideal Contributions

Expand Down Expand Up @@ -83,7 +83,7 @@ To avoid wasted effort, note that PRs in these categories are unlikely to be mer
### Setup

```bash
git clone https://github.com/locus/Locus.git
git clone https://github.com/aryanjsx/Locus.git
cd Locus
uv sync --extra dev
```
Expand All @@ -104,8 +104,8 @@ For detailed development setup, code conventions, and project structure, see the

## Claiming Issues

1. Browse the [Roadmap](https://locus.github.io/Locus/development/roadmap/) for an item that interests you
2. Check if a [GitHub issue](https://github.com/locus/Locus/issues) already exists for it — if not, [open one](https://github.com/locus/Locus/issues/new/choose) describing what you'd like to work on
1. Browse the [Roadmap](https://aryanjsx.github.io/Locus/development/roadmap/) for an item that interests you
2. Check if a [GitHub issue](https://github.com/aryanjsx/Locus/issues) already exists for it — if not, [open one](https://github.com/aryanjsx/Locus/issues/new/choose) describing what you'd like to work on
3. Comment **"take"** on the issue to get auto-assigned
4. Fork, branch, and start working

Expand All @@ -123,7 +123,7 @@ For small fixes (typos, doc improvements, simple bug fixes), go ahead and open a

For larger changes — new features, refactors, new dependencies — **open an issue first** to discuss the approach. This saves everyone time by catching design issues early.

Use the appropriate [issue template](https://github.com/locus/Locus/issues/new/choose):
Use the appropriate [issue template](https://github.com/aryanjsx/Locus/issues/new/choose):
- **Bug Report** — for bugs with reproduction steps
- **Feature Request** — for new functionality
- **New Eval Dataset** — for contributing benchmarks
Expand Down Expand Up @@ -197,5 +197,5 @@ This project follows the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.

## Questions?

- Open a [Discussion](https://github.com/locus/Locus/discussions) for questions and help
- Check the [documentation](https://locus.github.io/Locus/) for guides and API reference
- Open a [Discussion](https://github.com/aryanjsx/Locus/discussions) for questions and help
- Check the [documentation](https://aryanjsx.github.io/Locus/) for guides and API reference
3 changes: 2 additions & 1 deletion LICENSE
Original file line number Diff line number Diff line change
Expand Up @@ -175,7 +175,8 @@

END OF TERMS AND CONDITIONS

Copyright 2025 The Locus Authors
Copyright 2025 The OpenJarvis Authors
Copyright 2026 The Locus Authors (modifications)

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Expand Down
15 changes: 15 additions & 0 deletions NOTICE
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
Locus
Copyright 2026 The Locus Authors

This product is a modified version of OpenJarvis
(https://github.com/open-jarvis/OpenJarvis),
Copyright 2025 The OpenJarvis Authors, licensed under the Apache License,
Version 2.0. OpenJarvis was developed at Hazy Research and the Scaling
Intelligence Lab at Stanford University.

Modifications by the Locus Authors include renaming the project, its
package, command-line interface and desktop application to Locus, and
the changes recorded in this repository's git history.

Locus is not affiliated with or endorsed by Stanford University or the
OpenJarvis authors.
Loading
Loading