v0.3.0 — Desktop for Windows, Linux & macOS

Awareness v0.3.0 — Cross-platform desktop

Native desktop shells for Windows, Linux, and macOS. Same product model as the Swift macOS app: auto-start local awareness-api, open the loopback dashboard in an embedded window (no system browser required).

Downloads

Asset	Platform	Notes
Awareness-0.3.0-arm64.dmg	macOS 14+ Apple Silicon	Swift + WKWebView shell
Awareness-0.3.0-win-x64.exe	Windows x64	NSIS installer (Electron)
Awareness-0.3.0-win-x64.zip	Windows x64	Portable zip (Electron)
Awareness-0.3.0-linux-x86_64.AppImage	Linux x64	AppImage
Awareness-0.3.0-linux-amd64.deb	Debian/Ubuntu	.deb package
Awareness-0.3.0-linux-x64.tar.gz	Linux x64	Portable archive
SHA256SUMS-linux.txt / SHA256SUMS-windows.txt	—	Checksums

Install

macOS: Open the DMG → drag Awareness.app to Applications → first launch: right-click → Open (ad-hoc signed).

Windows: Run Awareness-0.3.0-win-x64.exe, or extract the zip.

Linux:

chmod +x Awareness-0.3.0-linux-x86_64.AppImage
./Awareness-0.3.0-linux-x86_64.AppImage
# or:
sudo dpkg -i Awareness-0.3.0-linux-amd64.deb

Python engine (required on all platforms)

The desktop app is a thin shell over the local API — same contract as macOS:

git clone https://github.com/nazmiefearmutcu/awareness.git
cd awareness
uv sync   # or: python3 -m venv .venv && pip install -e .

# optional discovery path the app looks for:
#   macOS/Linux:  ln -s "$PWD" ~/awareness_dev
#   Windows:      mklink /J %USERPROFILE%\awareness_dev %CD%

Env overrides: AWARENESS_API_BIN, AWARENESS_REPO, AW_API_HOST, AW_API_PORT (default 127.0.0.1:8085).

What's new

• Electron desktop for Windows & Linux (desktop/) with API lifecycle parity (attach / spawn / health / restart / stop)
• GitHub Actions Desktop Release workflow (native runners)
• macOS Swift app version 0.3.0 (DMG included)

Build from source

# macOS
./macos/Awareness/Scripts/make-dmg.sh

# Windows / Linux (on target OS or CI)
cd desktop && npm ci && npm test && npm run dist:win   # or dist:linux

Docs: desktop/README.md

Tag: v0.3.0 on feat/desktop-win-linux
CI: https://github.com/nazmiefearmutcu/awareness/actions/runs/29150194266

v0.2.1 — Native macOS app (DMG)

Awareness v0.2.1 — Native macOS app

First installable macOS package of the Awareness desktop shell.

Download

Asset	Platform	Notes
Awareness-0.2.1-arm64.dmg	Apple Silicon (arm64)	macOS 14+

SHA-256: c1269f268817edc00c0a3eba672729f189dba76292307eb7a7dba304defeb0f2

Install

1. Open the DMG and drag Awareness.app into Applications
2. First launch: right-click → Open (ad-hoc signed; Gatekeeper may warn once)
3. Install the Python engine (the app is a native shell over awareness-api):

git clone https://github.com/nazmiefearmutcu/awareness.git
cd awareness
uv sync   # or: python3 -m venv .venv && pip install -e .
ln -s "$PWD" ~/awareness_dev   # optional; app auto-discovers this path

What's in the app

• Native SwiftUI window + WKWebView dashboard (no Safari/Chrome)
• Auto-starts / health-checks / stops the local FastAPI process
• Full SPA parity: Dashboard, Captures, Work, Pipeline, Tail, Settings, ⌘K

Build from source

./macos/Awareness/Scripts/make-dmg.sh
# → dist/Awareness-<version>-<arch>.dmg

Notes

• Not notarized (ad-hoc codesign). Use right-click → Open on first run.
• Architecture: arm64 only in this release (built on Apple Silicon).
• Tag: v0.2.1 on feat/native-macos-app (b19c72a)

See also: macos/README.md

v0.2.0 — Work, Settings, monochrome UI

Awareness v0.2.0

Highlights

• Work: live job search across LinkedIn (public guest), Greenhouse/Lever/Ashby ATS, RemoteOK, Remotive, Arbeitnow, HN Who's Hiring, WWR
• Ranking: field-weighted personalization from your profile (roles, skills, places, remote, excludes)
• Settings hub: all user-tunable knobs in one place
  • Work profile + job boards
  • Tail seed feeds/sitemaps editor
  • Full engine CONFIG_SCHEMA (41 knobs → awareness.yaml)
  • Runtime / dedup status (read-only)
• UI: monochrome black/white desktop workbench (no accent colors)

API

• GET/PUT /jobsearch/profile, POST /jobsearch/search, GET /jobsearch/sources
• GET /settings/schema, PUT /settings/config
• GET/PUT /settings/tail-seeds

Notes

• LinkedIn uses the public guest surface (no login). Rate limits may apply.
• Env vars (AW_*) still override YAML and appear as locked in Settings.

Tag: v0.2.0 on feat/benchmarks (d215fae)

v0.1.0 — first public cut

awareness ingests the public web (Common Crawl + HF FineWeb + RSS + GDELT) onto your laptop and makes it queryable from DuckDB. One Python process — no Spark, no cloud.

Install (Python 3.11+)

pip install awareness-0.1.0-py3-none-any.whl       # plain
pipx install awareness-0.1.0-py3-none-any.whl       # isolated CLI
uv tool install awareness-0.1.0-py3-none-any.whl    # with uv

Quickstart

awareness --help        # all commands
awareness-api           # local web UI + API
awareness-worker        # run the ingest worker

Ingested rows land in a local DuckDB file you can query directly with SQL.