### Initialize and Run Development Environment Source: https://github.com/theexperiencecompany/gaia/blob/master/apps/desktop/README.md Commands to install dependencies and start the desktop application in development mode. ```bash # Install dependencies mise setup:desktop # Run in development mode (requires web dev server at localhost:3000) mise dev:desktop ``` -------------------------------- ### Initialize GAIA setup Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/developers/development-setup.mdx Run the interactive setup wizard to configure the local environment. ```bash gaia init ``` -------------------------------- ### Initialize and Start Development Server Source: https://github.com/theexperiencecompany/gaia/blob/master/apps/mobile/README.md Commands to install dependencies and launch the Expo development server from the monorepo root. ```bash # From monorepo root pnpm install # Start the Expo dev server mise run dev # or: cd apps/mobile && expo start ``` -------------------------------- ### Initialize GAIA setup Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/self-hosting/cli-setup.mdx Run the interactive setup wizard to clone the repository and configure the environment. Use the branch flag to target a specific repository branch. ```bash # Run the setup wizard gaia init # Clone a specific branch gaia init --branch develop ``` -------------------------------- ### Start development environment Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/developers/development-setup.mdx Launch the Nx TUI to begin development. ```bash gaia dev ``` -------------------------------- ### Start GAIA services Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/self-hosting/overview.mdx Execute the start command to launch all required services via Docker. ```bash gaia start ``` -------------------------------- ### Install and Initialize GAIA CLI Source: https://github.com/theexperiencecompany/gaia/blob/master/README.md Use these commands to install the global CLI and initialize the self-hosted stack via the interactive wizard. ```bash # 1. Install the CLI (pnpm add -g / bun add -g also work) npm install -g @heygaia/cli # 2. Clone, configure, and launch — the wizard walks you through it gaia init # pick "Self-Host (Docker)" when asked # 3. Open GAIA in your browser # http://localhost:3000 ``` -------------------------------- ### Install Mintlify CLI Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/README.md Global installation of the Mintlify CLI tool via npm. ```bash npm i -g mintlify ``` -------------------------------- ### gaia start Source: https://github.com/theexperiencecompany/gaia/blob/master/packages/cli/README.md Starts services for self-host mode using Docker. ```APIDOC ## gaia start ### Description Starts services for self-host mode. ### Parameters #### Flags - **--build** (boolean) - Optional - Rebuild Docker images before starting - **--pull** (boolean) - Optional - Pull latest base images before starting ``` -------------------------------- ### Install components via @heygaia/ui CLI Source: https://github.com/theexperiencecompany/gaia/blob/master/packages/gaia-ui/README.md Use the @heygaia/ui CLI to add specific components to your project. ```bash npx @heygaia/ui add chat-bubble npx @heygaia/ui add raised-button tool-calls-section ``` -------------------------------- ### gaia init Source: https://github.com/theexperiencecompany/gaia/blob/master/packages/cli/README.md Performs an interactive first-time setup of the GAIA environment. ```APIDOC ## gaia init ### Description Interactive first-time setup for GAIA. ### Parameters #### Flags - **--branch** (string) - Optional - Clone a specific branch ``` -------------------------------- ### gaia setup Source: https://github.com/theexperiencecompany/gaia/blob/master/packages/cli/README.md Reconfigures an existing GAIA repository. ```APIDOC ## gaia setup ### Description Reconfigure an existing GAIA repo. Must be run from within the repository directory. ``` -------------------------------- ### Reconfigure environment Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/developers/development-setup.mdx Run the setup command from the repository root to reconfigure the environment. ```bash gaia setup ``` -------------------------------- ### Apply basic commit types Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/configuration/conventional-commits.mdx Standard examples for common commit types. ```bash feat: add user authentication system fix: resolve login button not responding docs: update API documentation refactor: simplify user service logic ``` -------------------------------- ### Install Docker Engine on Ubuntu/Debian Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/self-hosting/docker-setup.mdx Commands to install Docker Engine and the Compose plugin on Debian-based systems, and configure user permissions. ```bash # Ubuntu/Debian (example) sudo apt-get update sudo apt-get install -y docker.io docker-compose-plugin sudo systemctl enable --now docker # Add user to docker group sudo usermod -aG docker $USER newgrp docker ``` -------------------------------- ### Start and Monitor Development Services Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/self-hosting/docker-setup.mdx Commands to initiate the development environment with hot reloading and follow real-time logs for backend and frontend services. ```bash # Start with hot reload docker compose up -d # View real-time logs docker compose logs -f gaia-backend frontend ``` -------------------------------- ### Install components via shadcn CLI Source: https://github.com/theexperiencecompany/gaia/blob/master/packages/gaia-ui/README.md Use the shadcn CLI to add components by providing the component JSON URL. ```bash npx shadcn@latest add https://ui.heygaia.io/r/chat-bubble.json ``` -------------------------------- ### Development Commands Source: https://github.com/theexperiencecompany/gaia/blob/master/apps/bots/slack/README.md Standard commands for installing dependencies and running the bot during development. ```bash # Install dependencies pnpm install # Run in development mode nx dev bot-slack # Build for production nx build bot-slack ``` -------------------------------- ### Start and Stop Gaia Services Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/self-hosting/docker-setup.mdx Commands to manage the lifecycle of the containerized services. ```bash # Start all services docker compose up -d # Start specific services docker compose up -d gaia-backend postgres redis # Stop all services docker compose down # Stop and remove volumes (⚠️ deletes data) docker compose down -v ``` -------------------------------- ### Run Docker services with profiles Source: https://github.com/theexperiencecompany/gaia/blob/master/infra/README.md Use profiles to selectively start specific service groups and their dependencies. ```bash docker compose --profile backend up # Backend + dependencies docker compose --profile worker up # Worker + dependencies docker compose --profile voice up # Voice agent ``` -------------------------------- ### Train the Hey GAIA wake-word model Source: https://github.com/theexperiencecompany/gaia/blob/master/libs/wake-word/training/README.md Commands to install dependencies, generate synthetic training data, download audio corpora, and execute the training process. ```bash # 1. Install deps (uses uv, mise will run this) uv sync # 2. Generate synthetic training audio (~75k clips, ~1 hour on a laptop) uv run python -m src.synthesize \ --phrases configs/hey_gaia.yaml \ --output data/synthetic \ --n_positive 50000 \ --n_hard_negative 25000 # 3. (optional) Download MUSAN noise + RIR datasets bash scripts/download_audio_corpora.sh data/ # 4. Train. ~1 hour on a single GPU, ~6 hours on CPU uv run python -m src.train \ --config configs/hey_gaia.yaml \ --data data/synthetic \ --models ../models ``` -------------------------------- ### Verify GAIA CLI installation Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/developers/development-setup.mdx Check that the CLI is installed and accessible in your terminal. ```bash gaia --help ``` -------------------------------- ### Initialize GAIA project Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/cli/commands.mdx Performs first-time setup including prerequisite checks and repository configuration. ```bash gaia init ``` ```bash gaia init --branch develop ``` -------------------------------- ### Start development environment Source: https://github.com/theexperiencecompany/gaia/blob/master/docs/configuration/environment-variables.mdx Launch the development environment using the configured settings. ```bash mise dev ```