Pipulate - Local-First AI Development

Install Pipulate: Be Running in 5 Minutes

Get started with the local-first revolution. Two commands and you’re running.

Quick Start Guide

1. Install Nix (One-Time Setup)

curl --proto '=https' --tlsv1.2 -sSf -L https://install.determinate.systems/nix | sh -s -- install

Close your terminal and open a new one after installation.

2. Install Pipulate

With a custom name

curl -L https://pipulate.com/install.sh | sh -s Botifython

Or default installation

curl -L https://pipulate.com/install.sh | sh

3. Run It

cd ~/Botifython
nix develop

These few commands:

That’s it! You now have a local-first development environment with AI integration.

4. Run It Again!

  1. You can just forcibly exit out of that Terminal it’s running from.
  2. Open a new Terminal, and once again:
cd ~/Botifython
nix develop

5. The Big Reset (If Necessary)

Things sometimes go wrong. This is how you do a full Pipulate reset. This will also delete anything you downloaded with Pipulate. Adjust custom install name to what you used.

rm -rf ~/Botifython
curl -L https://pipulate.com/install.sh | sh -s Botifython
cd ~/Botifython
nix develop

Wait for BOTH TABS to auto-open in your browser.

[Installation process diagram will be inserted here]

Force Restart

If you need to force-close everything:

  1. Press Ctrl+C repeatedly until the terminal exits
  2. Close the terminal window
  3. Open a new terminal
  4. cd ~/pipulate && nix develop

Uninstalling Nix

To remove Nix completely from your system:

/nix/nix-installer uninstall

System Requirements

What Gets Installed

The Nix environment includes:

About Nix

Pipulate uses Nix to ensure a consistent, reproducible environment across all operating systems:

This eliminates the “works on my machine” problem and ensures Pipulate runs reliably everywhere.

Not On My Machine Problem Fixed

The Cloud’s popularity has been driven in part by developers not wanting to maintain multiple codebases or installers per OS. Thanks to Nix, that’s all fixed.

     ____                      _       _                        .--.      ___________
    |  _ \  __ _ _ ____      _(_)_ __ (_)_  __    ,--./,-.     |o_o |    |     |     |
    | | | |/ _` | '__\ \ /\ / / | '_ \| \ \/ /   / #      \    |:_/ |    |     |     |
    | |_| | (_| | |   \ V  V /| | | | | |>  <   |          |  //   \ \   |_____|_____|
    |____/ \__,_|_|    \_/\_/ |_|_| |_|_/_/\_\   \        /  (|     | )  |     |     |
                                                  `._,._,'  /'\_   _/`\  |     |     |
    Solving the "Not on my machine" problem well.           \___)=(___/  |_____|_____|

Nix serves as the “Noah’s Ark” - preserving this perfect focus in a reproducible environment that works identically across all platforms. Once you’ve locked in the focus, it lasts for years or decades, all bottled up in infrastructure-as-code.

Multi-OS & CUDA Support (Nix)

Nix Flakes ensure a consistent environment across Linux, macOS, and Windows (via WSL), optionally leveraging CUDA GPUs if detected.

               ┌──────────────────┐
               │  Linux / macOS   │ - Write code once, run anywhere
               │  Windows (WSL)   │ - Consistent dev environment via Nix
               └────────┬─────────┘   - Like cross-OS Homebrew brew install
                        │
                        │ Nix manages dependencies
                        ▼
               ┌──────────────────┐
               │   CUDA Support   │ - Auto-detects NVIDIA GPU w/ CUDA
               │   (if present)   │ - Uses GPU for LLM acceleration
               └──────────────────┘   - Falls back to CPU if no CUDA

Next Steps

Once installed, explore:

  1. The WET Blueprint - Understanding the philosophy
  2. Local-First Revolution - Why it matters
  3. Building Workflows - Hands-on development
  4. GitHub Repository - Source code and community

Need Help?

Welcome to the local-first revolution! ```