Installation

Start with Explorer.

Install Ploinky, then use it to open an AssistOS workspace in your browser.

You need Git, Node.js 20 or later, and a working Docker or Podman installation. The commands below use Bash or Zsh.

1. Get Ploinky

Ploinky starts Explorer and its agents. Download the code and make its command available in this terminal.

git clone https://github.com/AssistOS-AI/ploinky.git
cd ploinky
npm install
export PATH="$PWD/bin:$PATH"

For new terminals, add the Ploinky bin directory to your shell's PATH as described in the Ploinky installation guide.

2. Start Explorer

In the same terminal, create a folder for your workspace and start Explorer there. Ploinky prepares the default repositories and required services on first use.

mkdir -p ../assistos-workspace
cd ../assistos-workspace
ploinky start explorer

Already have a workspace? Open that folder and run ploinky start explorer.

3. Open your workspace

When startup finishes, open the local dashboard and sign in, then open Explorer. These are the addresses for the default port.

Open the local dashboard 127.0.0.1:8080/dashboard Open Explorer 127.0.0.1:8080/#file-exp/

Use ploinky status to check the runtime and ploinky stop to stop it. See the Explorer startup instructions for the current version.

AssistOS is an open-source platform developed through the European research project Achilles. Individual agents can use different licenses. The Home film shows the experience we are building; installed features depend on the versions and agents you use.