Documentation

Rumima docs

Everything you need to install Rumima, activate your license, and keep working — online or up to ten days offline.

01 · Overview

Getting started

Rumima is an AI visual knowledge platform — a fast, voice-driven canvas for building mind maps, troubleshooting trees, and living documentation. It runs fully on your device; the network is only used for licensing and optional sync.

Rumima ships in three editions:

  • Free (Play) — the ad-supported edition for everyday personal maps. Distributed on Google Play for Android.
  • Pro — €24.99/yr — everything unlocked, ad-free. Available on Windows via this website and on Android via Google Play.
  • Enterprise — seat-based licensing with a central admin portal. Web only, purchased and managed on this website.

Which download do I need? Free and Pro for Android come from Google Play. Pro for Windows and all Enterprise seats are delivered from the Download page after you sign in.

02 · Install

Install on Windows

The Windows build is delivered through the website so it can be tied to your Pro or Enterprise entitlement.

  1. Sign in on the Download page with the account that holds your Pro subscription or Enterprise seat.
  2. Download the signed installer, Rumima-Setup-x64.exe.
  3. Run the installer and follow the prompts. It installs per-user and requires no administrator rights.
  4. Launch Rumima. On first start it prompts you to sign in and activate — see Activating your license.

System requirements: Windows 10 or 11 (64-bit), 4 GB RAM, and roughly 300 MB of disk space.

03 · Install

Install on Android

On Android both editions are published on Google Play, so updates and billing are handled by the Play Store.

Requires Android 8.0 or newer. After installing Pro, open the app and sign in to activate your license.

04 · Licensing

Activating your license

Activation binds your subscription to the device you are using. It happens automatically the first time you sign in:

  1. Sign in with your Agrarobotics account (Enterprise users sign in with the identity your admin assigned).
  2. Rumima computes a device fingerprint — a stable, non-reversible hash of hardware and OS attributes — and registers it as an activation.
  3. The app calls the licensing server (a Rust service on Google Cloud Run), which verifies your entitlement and returns an Ed25519-signed license token.
  4. The token is stored locally. From then on Rumima validates it against the embedded public key at launch — no network round-trip required.

A token is a small signed payload. Its claims look like this:

license token · claims
{
  "lid":      "lic_7Q2f9K4mXb",        // license / activation id
  "org":      "org_agrarobotics",      // null for personal Pro
  "tier":     "pro",                    // free | pro | enterprise
  "seats":    1,                        // seats this token represents
  "features": ["export.all", "encryption", "sync", "anki"],
  "exp":      1752566400             // unix expiry — now + 10 days
}

The signature covers the entire payload, so the claims — including tier, features, and exp — cannot be edited without invalidating the token.

05 · Licensing

Offline grace & revalidation

Rumima is built to keep working where the network doesn't — on a plane, in a plant, or on a field laptop. Every successful online check-in returns a fresh token with exp = now + 10 days.

  • While the current token is valid, the app runs fully offline — validation is a local signature check against the embedded public key.
  • When the remaining runway drops below about 3 days, Rumima silently refreshes in the background the next time it reaches the server, resetting the clock to a full 10 days.
  • Because exp lives inside the signed payload, it can't be forged or extended by editing local files or rolling back the system clock past the signature.

Only if a device stays offline for the entire grace window does the token lapse; the next successful sign-in re-issues one immediately.

# timeline of a single token day 0 check-in → new token exp = day 10 day 7 under 3d runway → silent refresh → exp = day 17 day 17 still offline? → prompt to reconnect
06 · Account

Managing your devices

A Pro subscription covers a small number of devices at once — for example your Windows PC and your Android phone. Each activation is one registered device fingerprint.

To free up a slot when you replace or retire a machine:

  1. Open your Account portal and go to Devices.
  2. Find the device you no longer use and choose Deactivate.
  3. That activation is released at once; the device loses its license at its next check-in, and the freed slot is available for a new install immediately.

Tip: deactivate a device before wiping or selling it. If you've already lost access, deactivating from the portal still frees the seat.

07 · Enterprise

Enterprise admin guide

Enterprise licensing is seat-based and managed centrally. Admins never touch individual token files — everything is done from the portal.

  1. Buy seats on the website. Choose a seat count (volume discounts apply) and complete checkout to create your organization's seat pool.
  2. Sign in to the Enterprise Portal with your admin account.
  3. Assign seats to users by email. On their next sign-in, Rumima activates against the assigned seat automatically.
  4. Revoke or reassign a seat instantly when someone leaves or changes roles — the old device loses access at its next check-in.
  5. Add seat packs mid-term as the team grows; packs are prorated to your renewal date.
  6. Renew annually from the portal to keep the whole pool active.
  7. Review audit logs — activations, device registrations, seat changes, and admin actions are all recorded and exportable.
08 · How it works

Licensing architecture

Rumima's licensing runs on a small, purpose-built stack on Google Cloud. Signing keys stay server-side; every client only carries the public key needed to verify tokens.

Signed seats, offline-first

A Rust API on Cloud Run issues Ed25519-signed tokens against a Postgres system of record, gated by Firebase Authentication, with the site and portals served from Firebase Hosting.

Cloud Run · Rust licensing API Cloud SQL / Postgres · orgs · seats · subscriptions · activations · audit Firebase Auth · sign-in + roles Firebase Hosting · site + portals Ed25519 · signed tokens · 10-day offline grace
09 · Help

Troubleshooting / FAQ

My license won't activate

Confirm you're signed in with the account that holds the subscription or assigned seat, and that you can reach the network. If your device slots are full, deactivate an old device from your Account portal, then retry.

I'm stuck offline / my license expired

Reconnect and open Rumima once — it re-issues a fresh 10-day token immediately. If the clock lapsed while offline, simply signing in again restores full access; no data is lost.

I moved to a new PC

Install Rumima on the new machine and sign in — it registers as a new device. If you're at your device limit, deactivate the old PC from the Account portal to free the slot.

How do I cancel?

Personal Pro on Android is managed through Google Play subscriptions. Website Pro and Enterprise are cancelled from the Account or Enterprise Portal — access continues until the end of the paid term.

Still stuck? Grab the latest build from the Download page, or reach us at hello@agrarobotics.com — include your license id (lid) so we can help faster.