Skip to content

matveynator/chicha-isotope-map

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,192 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🇬🇧 English | 🇫🇷 Français | 🇯🇵 日本語 | 🇨🇭 Schwiizerdütsch | 🇮🇹 Italiano | 🇨🇳 中文 | 🇮🇳 हिन्दी | 🇮🇷 فارسی | 🇷🇺 Русский | 🇲🇳 Монгол | 🇰🇿 Қазақша

Chicha Isotope Map logo

Chicha Isotope Map

Download page for the latest stable build: matveynator.github.io/chicha-isotope-map/doc/pages.
Radiacode, AtomFast, BGeigie Safecast devices supported.

Latest stable release build

Live demo

Desktop app (GUI)

Best for personal local use.

Download

Run

Windows:

  1. Download .exe directly (or .zip if your browser/security policy blocks direct .exe downloads)
  2. Double click
  3. If SmartScreen appears: More info → Run anyway

macOS:

chmod +x ./chicha-isotope-map_darwin_*_desktop
./chicha-isotope-map_darwin_*_desktop

Linux:

curl -fL https://github.com/matveynator/chicha-isotope-map/releases/download/stable-release/chicha-isotope-map_linux_amd64_desktop.zip -o chicha-isotope-map-desktop.zip
unzip chicha-isotope-map-desktop.zip
chmod +x ./chicha-isotope-map_linux_amd64_desktop
./chicha-isotope-map_linux_amd64_desktop

Linux desktop release now ships as a regular executable binary in a .zip archive.

Build desktop from source

Desktop WebView builds require CGO.

macOS/Linux:

CGO_ENABLED=1 go build -tags desktop .
./chicha-isotope-map -desktop

Server-only binary (no embedded desktop window):

CGO_ENABLED=0 go build .
./chicha-isotope-map

Screenshots:

desktop placeholder 1 desktop placeholder 2

Server version (self-hosted)

Quick start (Linux)

sudo curl -fL https://github.com/matveynator/chicha-isotope-map/releases/download/stable-release/chicha-isotope-map_linux_amd64 -o /usr/local/bin/chicha-isotope-map; chmod +x /usr/local/bin/chicha-isotope-map; /usr/local/bin/chicha-isotope-map;

Open: http://localhost:8765

Other server binaries

Public HTTPS domain

./chicha-isotope-map -domain your-domain.example

Ports 80/443 must be open.


Advanced flags and PostgreSQL

Useful flags

  • -port 8765
  • -domain your-domain.example
  • -default-lat, -default-lon, -default-zoom, -default-layer
  • -mapbox-token YOUR_TOKEN
  • -setup (Linux only)
  • -import-tgz-url URL
  • -import-tgz-path /path/to/file.tgz

Database flags

  • -db-type sqlite|duckdb|chai|clickhouse|pgx
  • -db-path /path/to/file
  • -db-conn CONNECTION_STRING

PostgreSQL example

./chicha-isotope-map \
  -db-type pgx \
  -db-conn 'postgres://USER:PASSWORD@HOST:5432/chicha?sslmode=allow' \
  -port 8765

Preload real tracks once

./chicha-isotope-map -import-tgz-url https://pelora.org/api/json/weekly.tgz

History and contributors

This project was conceived to grant people a clear and immediate understanding of radiation safety in the very places they inhabit—where they reside, labor, cultivate the land, and draw water.

The Chicha Isotope Map finds its roots in the field research of Dmitry Ignatenko and has been profoundly shaped by the insights of Rob Oudendijk and the Safecast community. We extend our sincere appreciation to Safecast, AtomFast, Radiacode, DoseMap, and the many contributors to open dosimetry whose efforts made this possible.

Should this work serve to safeguard even a single living being, its purpose shall be fully justified.