ARI.Software Docs

Core Concepts

Understand the fundamental architecture and principles of ARI.Software.

Hyper-Personal Software

ARI is built around a simple idea: the tools you use every day should be shaped around how you think and work, not the other way around. Instead of adapting your life to a generic app, ARI lets you build and customize exactly the workspace you need.

Every ARI instance is designed for one user: you. It is your personal, private, password-protected workspace where your tools, data, and workflows live together in one place.

Open Source

ARI is open source. You get complete access to the source code, full data ownership and control, full transparency in how the platform works, and the freedom to modify code.

Self-Hosted and Full Data Control

ARI runs wherever you want it to. Your own computer, a private server, a cloud hosting provider, or any infrastructure you control. Your data never leaves your environment unless you choose to share it.

You can export, back up, and migrate your data at any time. There is no vendor lock-in.

AI-Native

AI is not an afterthought in ARI. It is built into the platform from the ground up.

  • Module Builder — Describe what you need in plain English and the AI generates a complete module using Claude Code
  • AI Assistant — Built-in conversational help powered by your choice of AI provider (OpenAI, Anthropic, OpenRouter, or Google Gemini)
  • Task-Aware AI — The AI Assistant automatically receives context about your current tasks, making conversations more relevant and actionable

Tech Stack

ARI is built on modern, production-grade technologies:

  • Next.js 16 — React framework with App Router
  • React 19 — UI rendering
  • Drizzle ORM — Type-safe database access
  • TanStack Query — Data fetching with optimistic updates and cache management
  • Better Auth — Authentication and session management
  • PostgreSQL — Database with row-level security (local PostgreSQL, Supabase Local, or Supabase Cloud)
  • DM Sans — Default UI typeface

Data Fetching

ARI uses TanStack Query for all client-side data operations. This provides:

  • Optimistic updates — UI reflects changes instantly before the server confirms, then reconciles
  • Automatic cache invalidation — Related data refreshes when mutations succeed
  • Background refetching — Stale data is silently refreshed without blocking the UI
  • Error recovery — Failed mutations roll back optimistic changes automatically

Module developers benefit from this pattern — data operations in custom modules follow the same conventions used throughout ARI.

API-First

ARI has a robust API that allows integrations with external tools, services, and automation platforms. Every feature in ARI is accessible through the API, making it easy to connect your workspace to the rest of your workflow.

Modules

Everything in ARI is a module. A module is a self-contained application that plugs into the ARI platform with its own pages, data, and functionality.

ARI ships with dozens of built-in modules covering productivity, creativity, organization, and more. The real power is that you can build entirely new modules in minutes using natural language — no coding required.

Built for Individuals

ARI is not designed for millions of users. It is designed for one user — you. It is your personal workspace where your tools, data, and workflows live together. You can host it anywhere and even run it on your own custom domain.

Future updates may support teams and organizations.

Your Personal Workspace. Your Rules.

Open Source. Self-Hosted. Full Data Control. Fully Extendable. AI Native. Dozens of Built-In Modules And Build Your Own In Minutes. No Coding Required.

Download