| name | space-agent-setup |
| description | Install and run Space Agent on Surface Pro 3 — release AppImage or dev clone, user creation, startup |
| version | 1 |
| author | Marco |
| metadata | {"hermes":{"tags":["space-agent","electron","ai-agent","desktop"],"category":"autonomous-ai-agents"}} |
Space Agent Setup
Space Agent (agent0ai/space-agent) is a browser-first AI agent runtime. Available as:
- Release: pre-built AppImage (v0.64+)
- Dev: git clone + npm install
Release Install (Surface)
1. Download AppImage
curl -sL "https://github.com/agent0ai/space-agent/releases/download/v0.64/Space-Agent-0.64-linux-x64.AppImage" -o ~/Downloads/space-agent.AppImage
chmod +x ~/Downloads/space-agent.AppImage
2. Extract (FUSE workaround)
Surface Pro 3 lacks FUSE. Extract instead of running directly:
cd ~/Downloads
./space-agent.AppImage --appimage-extract
3. Move to permanent location
mkdir -p ~/.space-agent
cp -r squashfs-root/* ~/.space-agent/
chmod +x ~/.space-agent/space-agent
4. Run
sudo -u marco env DISPLAY=:0 HOME=/home/marco DBUS_SESSION_BUS_ADDRESS=unix:path=/run/user/1000/bus ~/.space-agent/space-agent --no-sandbox
See surface-gui-app-launch skill for the full sudo env pattern.
Dev Install
git clone https://github.com/agent0ai/space-agent.git ~/space-agent-dev
cd ~/space-agent-dev
npm install
First admin user:
cd ~/space-agent-dev
node space user create admin --password "change-me-now" --full-name "Admin" --groups _admin
Start dev server:
cd ~/space-agent-dev
PORT=3000 node space serve
Desktop Launcher
[Desktop Entry]
Name=Space Agent
Exec=/home/marco/.space-agent/space-agent --no-sandbox %U
Terminal=false
Type=Application
Icon=/home/marco/.space-agent/space-agent.png
Categories=Development
mkdir -p ~/.local/share/applications/
mv space-agent.desktop ~/.local/share/applications/
update-desktop-database ~/.local/share/applications/
Notes
- Space Agent is an Electron app (~1.4GB RAM when running)
- AppImage extracted to
/tmp/squashfs-root/ won't survive reboot — always use ~/.space-agent/
- First run requires creating an admin user via CLI before login works