Personal releases runs on your own machine Personal: Apache 2.0

Your agents run at home. Genie puts them in your pocket.

Ask Genie from your iPhone. Research a topic, prepare a briefing, watch for a change, or turn a repeated request into a scheduled agent. Run it, follow its progress, inspect what Genie built, and pause or cancel it from the same phone. Your gateway remains on infrastructure you control.

Use the same gateway from the channels you already have. WhatsApp, Telegram, Slack, Discord, email, HTTP, and custom adapters are first class channels. They reach the same agents, permissions, memory, schedules, and run history as Genie.

It also learns how your days work, what you have promised, and who is waiting on you. It does this by asking, not by watching. Expect a terminal and about ten minutes for a local install; cloud launchers are available below.

$ curl -fsSL https://soulacy.io/install.sh | bash
Binary Size Build-dependent 44.2 MB measured example
Idle RAM Depends on setup Local model memory is extra
Start Time Readiness-checked Hardware and services matter
Dependencies Core: no Node/Python Tools and providers may need more

Personal's prebuilt gateway includes the web UI; platform libraries, TLS trust, model access, and optional tool runtimes still apply. Size excludes the CLI, container image, and model downloads. Measurement details and requirements →

Interactive Prompt Injection Sandbox

Probe the deterministic pattern scanner & intent gate rules in real-time.

Input Payload (e.g. tool output, untrusted web page, or user chat): <external_content>
Activity: Security Doctor · Interactive Sandbox
Scanner rules matches: 0 Max Finding: none

Most assistants answer questions. This one keeps track.

Ask a chatbot the same thing twice and it has forgotten you in between. Soulacy keeps a structured picture of how your days actually go: your routine, the people who matter, and what you owe. Every agent you run reads the same one.

it learns you, by asking

Not a chat history. It asks a few questions on your first day and records your answers in your words. A conversation in your browser: no phone, no sensors, nothing switched on.

it can also notice (optional)

Add the iPhone app and allow a sense, and it keeps up on its own: a deadline moving, a Focus turning on, today not looking like a normal Tuesday. Skip it and Soulacy still works.

it stays quiet

“Nothing needs you today” is a real answer, and the system prefers it. An assistant that finds something urgent every morning is one you stop reading.

Ask from your phone. Genie builds the automation.

Genie is the native iPhone way into Soulacy. Ask a question and get an answer now. Ask for something to happen repeatedly, such as “summarise overnight news every weekday at seven”, and Genie creates the agent and schedule on your gateway.

Genie does not sit between your other channels and the gateway. An agent connected to WhatsApp, Telegram, Slack, Discord, email, or HTTP can receive requests and reply there directly. Scheduled results can be delivered there too.

it asks, rather than guesses

It uses what you actually have

The builder reads what is actually installed on your gateway. If you ask for email and no email channel is configured, it tells you before building anything. You do not have to discover the problem after a month of missing deliveries.

from request to result

Run it and receive it on iPhone

Follow active work and receive completed results in the durable mobile inbox. A missed push does not lose the result; it stays on your gateway until the app retrieves it.

and you can stop it

Still under your control

Ask Genie what it built, inspect recent delegated work, and pause or cancel recurring automation in the same conversation. Risky steps wait for your approval; Genie cannot approve itself.

Safety you cannot forget to add.

What an agent may do is enforced by the runtime. Agents fail closed by default. A privileged action proceeds only after a recorded approval or an explicit agent and gateway policy grant you can inspect.

untrusted by default

A web page is evidence, not instructions

Anything fetched from outside, including a page, document, or MCP server response, arrives as untrusted content and is scanned for injection before the model reads it. Text in a document cannot authorise a tool call.

privilege is declared

Two gates, both readable

OS-level tools need the server to permit them and the agent to declare them. On a managed platform where you have no shell of your own, the grant is refused outright. You cannot repair what you cannot reach.

attended and unattended differ

Nobody present means no

An action that needs approval does not quietly approve itself because it ran at 3am. It proceeds unattended only when the agent and gateway carry the required explicit grants; otherwise the run is refused.

evidence, not assertion

A reply is not proof

Agents are held to what tools actually returned. A failed delivery is recorded with a category instead of a cheerful summary. Twelve stable classifications make sure “it did not send” always says why.

Try the injection sandbox above, or read the security model.

Your automation command center, in your pocket.

Talk to Genie, start agents, follow live work, receive results, manage recurring automation, and approve decisions from the native iPhone app. It talks to your gateway, not to us.

Ask Genie to handle it

Request research now, schedule a morning brief, monitor a page, or have the result delivered to your inbox. Genie turns the request into visible work on your gateway.

Approve on the lock screen

When an agent needs a decision, it asks there and explains what it intends to do. Siri, Shortcuts, CarPlay and the share sheet all land in the same gateway.

Signals, off until you allow them

Location, calendar, reminders, motion, Health totals and Focus state reach only an agent that declares them, and only after you enable the matching toggle on the phone.

How the iPhone app works →

On Android too.

The Android companion pairs with your gateway by QR code, chats with your agents as they stream their replies, and asks for your fingerprint, face or screen lock before any approval. Results and approval requests arrive as notifications. Like the iPhone app, it talks to your gateway, not to us, and carries no analytics.

Download

Requires Android 8.0 or newer. Each release is a signed APK published on GitHub.

Check the download before installing. The two values must match:

curl -fsSL https://soulacy.io/android.apk.sha256
shasum -a 256 soulacy-android.apk

Install and pair

  1. Open the downloaded soulacy-android.apk on your phone.
  2. When Android asks, allow installs from your browser or file manager for this one install. You can switch it off again afterwards.
  3. In the Soulacy web workspace, choose Mobile → Pair a phone.
  4. In the app, choose Scan pairing code. The code works once and expires in two minutes.

Updates install over the old version because every release is signed with the same key. Android only accepts an update from that key.

self-hosted Personal

Run Personal on your infrastructure.

A gateway with an embedded web UI and a locally-issued API key. Configure your model provider and verify readiness before using it.

AWS · EC2

Deploy to AWS

guided setup

Creates an isolated network, encrypted Ubuntu VM, generated login secret, Postgres, Qdrant, automatic recovery, and an HTTPS endpoint. No inbound SSH.

Deploy to AWS Typically 8-12 minutes

After creation, use the direct Secrets Manager link in CloudFormation Outputs. Reveal api_key, sign in, then pair your iPhone from Mobile.

Microsoft Azure · VM

Deploy to Azure

guided setup

Creates a private virtual network, encrypted Ubuntu VM, static address, Postgres, Qdrant, and an Azure-hosted HTTPS endpoint. No inbound SSH.

Deploy to Azure Typically 8-15 minutes

Azure asks you to choose a 24+ character Soulacy login key. Save it, open the deployment URL, then pair your iPhone from Mobile.

Railway · Docker

Deploy to Railway

guided setup

Deploys the complete Personal gateway with HTTPS, persistent storage, health monitoring, and unique generated login and signing secrets. No configuration fields are required.

When it is online, open Railway Variables, reveal SOULACY_SERVER_API_KEY, and use it once to sign in. Then pair the iOS app from Soulacy’s Mobile screen.

One secure mobile handoff · every cloud

Sign in once. Pair your iPhone without copying the permanent key.

AWS generates the key in Secrets Manager, Azure asks you to choose it, and Railway generates it in Variables. After signing in to your new Soulacy URL, choose Mobile → Pair a device. The QR code expires in two minutes, works once, and gives the iOS app a scoped credential stored in Keychain.

Permanent key stays private
Never placed in a QR code, URL, or notification.
Render · Blueprint

Deploy to Render

one click

Creates a Docker web service with a persistent disk, production security profile, health monitoring, and generated login and session secrets.

Render generates the Soulacy login key; save it from the service environment after provisioning.

Coolify · Your VPS

Deploy with Coolify

self-hosted

Runs the published Personal image on infrastructure you control, with durable workspace storage and explicit login and JWT secrets.

The repository includes a ready-to-import Compose file; Coolify provides the domain and TLS proxy.

or install on your own machine
macOS · Linux

One-line install

$ curl -fsSL https://soulacy.io/install.sh | bash

Installs soulacy + sy into ~/.local/bin. Boots with a printed API key.

Docker · production

Full stack

$ docker compose up

Postgres + Qdrant + gateway. Security posture defaults ON (intent-gate=deny, sandbox=on, profile=production).

Docker · lite

SQLite-only

$ docker compose -f docker-compose.lite.yml up

Embedded storage in one container, without a separate database service. Model access and optional tools still have requirements.

On a managed platform such as Railway, Render, Fly, or Cloud Run, you have no shell of your own. Soulacy refuses to hand an agent one and installs Skills and MCP servers through an approved path instead. It tells you what your deployment can and cannot do before a step fails. What your deployment can do →

Six worked use cases, each with a way to check the result.

What Soulacy is not.

Not a hosted assistant

There is nothing to sign up for. It runs on your laptop, a small VPS, or a Raspberry Pi, and what it learns about you stays there. About Personal →

Not a node editor

You build by asking, and what comes out is a readable file rather than boxes on a canvas. If you want drag-and-drop nodes, use n8n or Flowise.

Not another framework

Frameworks give you libraries and leave you to build and host the application. This is the application: UI, login, channels, schedules and memory already inside one binary.

Feature-by-feature comparison →

Ask Genie from your iPhone.
Keep the runtime yours.

Build, run, and manage everyday automation from your phone. Risky actions pause for approval; unattended work follows explicit policy you can inspect.