Skip to main content

Istota

GitHub stars GitHub forks Last commit License

Istota is a self-hosted personal AI operating system. It runs on a server or VM of your own and brings calendars, email, files, location, health, money, feeds, conversations, and memory into one command layer. You can use all of those sources or only the ones you choose.

The native modules remain useful without a model. They have their own storage, command-line interfaces, and web pages. The agent adds a shared language interface and can reason across the records a task is allowed to read.

Istota works with Claude through the Claude Code CLI or with any OpenAI-compatible endpoint, including OpenRouter and local model servers. You can talk to it through the built-in web app, WhatsApp, SMS, email, Nextcloud Talk, a watched TASKS.md file, the terminal REPL, or the CLI.

One server can host several separate personal systems. Each user has their own memory, files, credentials, module data, rooms, and task queues. Shared rooms and files are explicit.

Istota is pre-1.0 software under active development. Interfaces, configuration, and database schemas may change between releases. Pin a release and read the changelog before upgrading.

A personal agent on rails​

A dependable personal agent needs more than a model loop. Istota gives it known ways to act, boundaries around those actions, durable state, and background execution.

PartWhat it does
Curated skillsA maintained set of skills exposes structured commands for calendars, email, files, memory, health, money, feeds, and connected services.
Durable executionEvery request enters a queue with a task identity, status, brain, permissions, retries, streamed events, and usage records.
Structured personal dataHealth, location, money, feeds, and briefings have schemas, per-user storage, command-line interfaces, and web pages.
Durable memoryPer-user and per-room memory, hybrid search, a temporal knowledge graph, and learned playbooks carry facts and decisions across sessions.
Proactive workScheduled jobs, reminders, briefings, and heartbeat checks run beyond a single chat turn. Deterministic jobs can run without a model.
Human controlConfirmations, notifications, audit logs, explicit resource grants, and administrator-only operations keep consequential actions visible.
Web chat ──────────┐
Nextcloud Talk ────┤
WhatsApp ──────────┤
SMS ───────────────┤
Email ─────────────┤
TASKS.md ──────────┼──> durable task queue ──> prompt + relevant data ──> Brain
CLI / REPL ────────┤ │ │
Scheduled jobs ────┤ │ ├──> skills and connected services
Heartbeat checks ──┘ │ ├──> native modules
│ └──> streamed response
└──> memory, resources, room history

Read the architecture overview for the full task path and module map.

Personal data stays under your control​

Location, health, financial, calendar, email, and conversation records form an unusually complete account of a person. Istota is self-hosted so that record can remain on infrastructure you administer. Its data lives in SQLite and plain formats such as Markdown, TOML, CSV, JSON, and Beancount.

Self-hosting does not make connected services disappear. A hosted model provider receives the prompts and tool results sent to it, and every service you connect receives the traffic needed to use it. Istota also supports a local OpenAI-compatible model endpoint. Those connections are operator choices rather than requirements of an Istota account or control plane.

Every task is confined by bubblewrap, credential isolation, scoped files, an outbound network proxy, and optional confirmation gates. Read the security model before exposing an instance or giving it sensitive resources.

Nextcloud is optional​

Nextcloud is a first-class integration, not the foundation of the system. When connected, it provides files, calendars, contacts, OAuth login, notifications, and Talk while Istota acts as an ordinary Nextcloud user over standard protocols.

Without Nextcloud, the workspace is an ordinary local directory in the stack's state, web chat handles conversations, and CalDAV and IMAP can point at other providers. istota setup asks which you want. Read the Nextcloud guide for the integration itself.

Principles​

Istota ships with an Emissaries layer that defines what a personal agent owes to its user and to people it encounters on that user's behalf. It separates private counsel from public action, treats access to private data as power, and keeps outward commitments answerable to a person. Structural security remains separate: sandboxing, credential isolation, and confirmation gates enforce boundaries that a prompt cannot.

This view shares the humanist premise of Common Task: people are ends rather than inputs to a system, and technology should be judged by how it affects their agency and well-being.

Installation​

Istota has one deployment: a stack of containers on a Debian 13 machine of its own, built from a signed release, with bubblewrap and per-task cgroups, and managed with one command, istota-stack. The machine can be a VPS, a VM on your own hardware, or a Lima VM on a Mac, and the stack is the same on each. Nextcloud is optional. The quickstart covers a server, and the local install a Mac.

The older standalone install, an unsandboxed single-user process, was removed. istota-stack import-standalone moves an existing one into the local VM: see Moving from the standalone install.

Explore the documentation​

License​

Istota is released under the European Union Public Licence 1.2 (EUPL v1.2). It permits commercial use, but modified versions distributed or provided to the public as a network service must keep their source available under the license terms.