AIOS Monorepo

What is AIOS Monorepo?

The AIOS Monorepo contains the Artificial Intelligence Operating System (AIOS) project, split into an Electron-based desktop frontend application and a Python-based LangGraph backend server. It is intended for developers who want to build or run AIOS locally.

How to use AIOS Monorepo?

Set up the backend first: navigate to aios-langgraph-server, copy .env.example to .env, create a virtual environment with uv venv, activate it, run uv sync, then start the server with langgraph dev --no-browser. Then set up the frontend: navigate to aios-desktop-app, copy .env.example to .env, run npm install, then launch with npm run dev. The desktop app connects to the locally running backend.

Key features of AIOS Monorepo

• Electron-based desktop frontend application
• Python LangGraph backend server for AI functionalities
• Uses uv Python package manager
• Hot‑reloading during development
• Production build scripts for Windows, macOS, and Linux

Use cases of AIOS Monorepo

• Running the AIOS desktop application locally
• Developing and testing AI workflows with LangGraph
• Providing a user interface for interacting with AI services
• Packaging the frontend for distribution on multiple platforms

FAQ from AIOS Monorepo

What are the prerequisites for running AIOS Monorepo?

Node.js (LTS recommended) and npm, Python 3.12.4 and pip, and the uv Python package manager.

How do I start the backend server?

After setting up the aios-langgraph-server directory, activate the uv virtual environment and run langgraph dev --no-browser. The server typically starts at http://localhost:2024.

How do I start the frontend desktop app?

After setting up the aios-desktop-app directory, run npm run dev to launch the Electron application with hot‑reloading enabled.

Where do I configure environment variables?

Both the backend and frontend use a .env file copied from .env.example. You must fill in necessary variables (e.g., API keys, database credentials) before running.

How do I build the desktop app for production?

Navigate to aios-desktop-app and use the commands npm run build:win, npm run build:mac, or npm run build:linux for the respective platform.