Skip to content

AHGRoach/RoachNet

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

425 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

RoachNet

Your stuff, still here when the internet isn't.

RoachNet is a local-first command center for offline maps, local AI, education, saved websites, and your own notes. It keeps the important parts of your workflow on your machine, so bad Wi-Fi, outages, and cloud slowdowns do not take the rest of your day down with them.

roachnet.org
GitHub Releases

What You Get

  • Command Deck One calm place for runtime health, maps, education, archives, and local AI.
  • RoachClaw RoachNet's local AI path, built around Ollama and OpenClaw with a fast local default model.
  • Offline Maps Curated map collections and route-aware surfaces that stay available when the network drops.
  • Education Wikipedia and Khan Academy-style offline learning content, grouped in one place.
  • Archives Saved websites and captured references for offline browsing.
  • Contained Install App, runtime data, workspace, and support services stay grouped near the RoachNet install root instead of being smeared across the OS.

Download

Start with RoachNet Setup.

The installer checks the machine, prepares the local runtime, aligns RoachClaw, and then hands off into the main RoachNet app.

Current Product Direction

RoachNet is moving toward fully native desktop apps:

  • macOS Apple Silicon SwiftUI/AppKit shell and native installer flow
  • Windows 11 x64 WinUI 3 scaffold in progress
  • Linux GTK4/libadwaita scaffold in progress

The current shipping focus is the macOS-native path, with the website and GitHub release flow centered on the native installer.

RoachClaw

RoachClaw is the default local AI lane inside RoachNet.

It brings Ollama and OpenClaw together so the app can:

  • detect local model availability
  • save a machine-appropriate default model
  • keep local chat working even when OpenClaw's agent runtime is not yet online
  • grow into agent workflows later without forcing remote providers first

For this release, RoachNet prefers qwen2.5-coder:7b as the default local RoachClaw model because it is a better fit for everyday work plus coding on this setup than the heavier defaults we were previously surfacing.

Repo Layout

  • admin/ Local API, web admin, RoachClaw services, maps, archives, and content plumbing
  • native/macos/ Native macOS app and installer
  • website/ RoachNet.org landing page and downloadable installer assets
  • scripts/ Setup, runtime, native bundling, and asset preparation scripts
  • docs/ Architecture notes, evaluations, and rewrite plans

Local Development

From the repo root:

npm start

No-browser boot:

npm run start:no-browser

Native macOS app build:

node scripts/build-native-macos-apps.mjs

Setup backend:

npm run setup:no-browser

Upstream Attribution

RoachNet started from an imported upstream base from Crosstalk Solutions project-nomad and is being reshaped into a calmer, product-grade local command center with native installers, local AI, contained runtime management, and a more cohesive desktop UX.

See:

License

This repository currently carries the upstream Apache 2.0 license from the imported base. Review LICENSE and docs/UPSTREAM.md before changing attribution or licensing details.

About

Your stuff, still here when the internet isn't. Offline maps, local AI, and your own notes in one calm local-first command center.

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors