12Personal assistant / R&D

Maya

One brain, more than one interface. A personal assistant built around a shared protocol and actions you can review.

Discipline
Software Development
Maya / SYSTEM MODEL01
System architecture
  1. 01
    Brain

    Python server: orchestration, voice and tool routing.

  2. 02
    Faces

    Electron and React Native clients sharing one WebSocket protocol.

  3. 03
    Tools

    Prepare an action, show its preview, receive approval, execute.

Architecture model based on the Maya repository — not a product screenshot

The problem to structure.

A personal assistant can quickly become a tightly coupled collection of prompts, interface code and tool calls. Maya explores a different architecture: separate the reasoning server, the interfaces and the tools so that another interface does not require another assistant.

02Implementation

How the pieces connect.

A Python server handles orchestration, voice and tool routing. Electron and React Native clients exchange state through a WebSocket protocol. Tools declare the risk of each operation and separate preparation from execution; email and calendar changes can be presented for review before an approval is sent back. This is a personal development project, not a public SaaS product.

03Inside the system

Below the interface.

01

One protocol, multiple clients

Python / WebSocket / Electron / Expo

The clients display state, accept input and return approval decisions. Orchestration stays on the server, which keeps the interface from owning the assistant’s logic.

02

Review the action itself

Tool contracts / preparation / approval

Preparation produces the action that the interface displays for review. Execution is a separate step, allowing the person to inspect the proposed email or calendar entry first.

04Delivered

A personal assistant architecture with a shared Python server, desktop and mobile clients, and a preview-and-approval path for tool actions.

Back to all work
Next / your project

A similar challenge?

An idea, a bottleneck, a system that has outgrown its tools. Tell us where you are.

Tell us about it