Quickstart

Install Ocsidian and go from zero to a playable scene in under five minutes.

This guide takes you from installation to your first generated scene. You’ll install Ocsidian, create a project, describe a scene, and preview it live in Unreal Engine.

1. Install Ocsidian

Download the installer for your platform from the download page.

macOS

• macOS 13 (Ventura) or later
• Apple Silicon or Intel
• Native .dmg installer

Windows

• Windows 10 (build 1903+) or later
• Native .exe installer

Linux

# Debian / Ubuntu
curl -fsSL https://downloads.ocsidian.ai/keys/ocsidian.asc | gpg --dearmor | sudo tee /etc/apt/keyrings/ocsidian.gpg > /dev/null
echo "deb [arch=amd64,arm64 signed-by=/etc/apt/keyrings/ocsidian.gpg] https://downloads.ocsidian.ai/apt stable main" | sudo tee /etc/apt/sources.list.d/ocsidian.list > /dev/null
sudo apt update && sudo apt install ocsidian

2. Sign in and create a project

Open Ocsidian, sign in with your account, and click New Project. Choose a template or start from a blank Unreal project. Ocsidian auto-detects your local Unreal Engine installation.

3. Describe your first scene

Open the prompt bar with Cmd+I (macOS) or Ctrl+I (Windows/Linux) and describe what you want:

Create a medieval village at dusk with stone buildings, 
a central fountain, torchlit streets, and a distant mountain range. 
Add ambient wind and fire particle effects.

Ocsidian generates the scene in real time. You’ll see a progress indicator as it creates the level geometry, materials, lighting, and particle systems.

4. Preview and iterate

Once generation completes, click Playto enter the scene in first-person. Use the prompt bar to make changes — “add rain”, “make the torches brighter”, “add a blacksmith NPC near the fountain”.

Next steps