Initial commit: extracted from memex

deploy/bare-metal/install.sh

@@ -0,0 +1,46 @@
+#!/bin/bash
+# org-agent: Bare Metal Installation Script
+# This script sets up the org-agent daemon on a Linux host (Debian/Fedora).
+
+set -e
+
+echo "--- org-agent: Bare Metal Installation ---"
+
+# 1. Check Dependencies
+echo "[1/4] Checking dependencies..."
+for cmd in sbcl curl git ripgrep; do
+    if ! command -v $cmd &> /dev/null; then
+        echo "Error: $cmd is not installed. Please install it first."
+        exit 1
+    fi
+done
+
+# 2. Setup Quicklisp
+if [ ! -d "$HOME/quicklisp" ]; then
+    echo "[2/4] Quicklisp not found. Installing..."
+    curl -O https://beta.quicklisp.org/quicklisp.lisp
+    sbcl --non-interactive --load quicklisp.lisp --eval '(quicklisp-quickstart:install)'
+    rm quicklisp.lisp
+    echo "Quicklisp installed."
+else
+    echo "[2/4] Quicklisp already installed."
+fi
+
+# 3. Build standalone binary
+echo "[3/4] Building standalone binary..."
+PROJECT_ROOT=$(pwd)/../..
+sbcl --non-interactive \
+     --eval "(push \"$PROJECT_ROOT/\" asdf:*central-registry*)" \
+     --eval "(ql:quickload :org-agent)" \
+     --eval "(asdf:make :org-agent)"
+
+echo "Binary built: $PROJECT_ROOT/org-agent-server"
+
+# 4. Instructions for Systemd
+echo "[4/4] Installation complete."
+echo ""
+echo "To run as a systemd service:"
+echo "1. Edit org-agent.service to set correct paths."
+echo "2. sudo cp org-agent.service /etc/systemd/system/"
+echo "3. sudo systemctl daemon-reload"
+echo "4. sudo systemctl enable --now org-agent"

deploy/bare-metal/org-agent.service

@@ -0,0 +1,18 @@
+[Unit]
+Description=org-agent: Neurosymbolic Lisp Machine Kernel
+After=network.target
+
+[Service]
+Type=simple
+# Update User and WorkingDirectory to match your local setup
+User=amr
+WorkingDirectory=/home/amr/.openclaw/workspace/memex/5_projects/org-agent
+ExecStart=/home/amr/.openclaw/workspace/memex/5_projects/org-agent/org-agent-server
+Restart=always
+RestartSec=10
+
+# Environment variables can be loaded from the .env file
+EnvironmentFile=/home/amr/.openclaw/workspace/memex/5_projects/org-agent/.env
+
+[Install]
+WantedBy=multi-user.target

deploy/docker/Dockerfile

@@ -0,0 +1,41 @@
+FROM debian:bookworm-slim
+
+# Install SBCL, ripgrep, and build dependencies
+RUN apt-get update && \
+    apt-get install -y sbcl build-essential curl git ripgrep libsqlite3-dev lynx python3 python3-pip && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+# Install Quicklisp globally
+RUN curl -O https://beta.quicklisp.org/quicklisp.lisp && \
+    sbcl --non-interactive \
+         --load quicklisp.lisp \
+         --eval '(quicklisp-quickstart:install :path "/opt/quicklisp")' \
+         --eval '(ql-util:without-prompting (ql:add-to-init-file))' && \
+    rm quicklisp.lisp
+
+# Set up the working directory
+WORKDIR /app
+
+# Copy source code and system definition
+COPY org-agent.asd /app/
+COPY src/ /app/src/
+
+# Build the standalone binary natively inside the container
+# This ensures GLIBC compatibility with the runtime environment.
+RUN sbcl --non-interactive \
+         --eval '(push "/app/" asdf:*central-registry*)' \
+         --eval '(ql:quickload :org-agent)' \
+         --eval '(asdf:make :org-agent)'
+
+# Ensure the binary is executable
+RUN chmod +x /app/org-agent-server
+
+# Expose the OACP and Web Dashboard ports
+EXPOSE 9105 8080
+
+# The app expects the memex to be mounted here
+VOLUME /memex
+
+# Run the natively compiled standalone daemon
+CMD ["./org-agent-server"]

deploy/docker/docker-compose.yml

@@ -0,0 +1,20 @@
+version: '3.8'
+
+services:
+  org-agent:
+    build:
+      context: ../..
+      dockerfile: deploy/docker/Dockerfile
+    container_name: org-agent
+    restart: unless-stopped
+    ports:
+      - "${ORG_AGENT_DAEMON_PORT:-9105}:${ORG_AGENT_DAEMON_PORT:-9105}"
+      - "${ORG_AGENT_WEB_PORT:-8080}:${ORG_AGENT_WEB_PORT:-8080}"
+    volumes:
+      - /docker/memex:/home/amr/.openclaw/workspace/memex
+    env_file:
+      - .env
+
+networks:
+  sandbox-net:
+    driver: bridge

deploy/guix/manifest.scm

@@ -0,0 +1,14 @@
+;; org-agent: Guix Environment Manifest
+;; Usage: guix shell -m manifest.scm -- sbcl --eval ...
+
+(specifications->manifest
+ '("sbcl"
+   "sbcl-cl-json"
+   "sbcl-bordeaux-threads"
+   "sbcl-usocket"
+   "sbcl-dexador"
+   "sbcl-cl-ppcre"
+   "ripgrep"
+   "git"
+   "curl"
+   "sqlite"))

deploy/lxc/setup.org

@@ -0,0 +1,33 @@
+#+TITLE: LXC / Systemd-nspawn Deployment Guide
+#+AUTHOR: org-agent
+
+* Overview
+For users who prefer containerization without the overhead or dependency on the Docker daemon, `org-agent` can be run within a standard Linux Container (LXC) or a systemd-nspawn container.
+
+* Systemd-nspawn Setup (Fastest for Linux users)
+
+1. **Create the container root:**
+   #+begin_src bash
+   sudo debootstrap --arch=amd64 bookworm /var/lib/machines/org-agent
+   #+end_src
+
+2. **Start and enter the container:**
+   #+begin_src bash
+   sudo systemd-nspawn -D /var/lib/machines/org-agent
+   #+end_src
+
+3. **Install dependencies (inside container):**
+   #+begin_src bash
+   apt-get update && apt-get install -y sbcl curl git ripgrep libsqlite3-dev build-essential
+   #+end_src
+
+4. **Bind mount the Memex directory:**
+   Add this to your container startup or use the `--bind` flag:
+   #+begin_src bash
+   sudo systemd-nspawn -D /var/lib/machines/org-agent --bind /home/amr/.openclaw/workspace/memex
+   #+end_src
+
+* Proxmox LXC Setup
+1. Create a new LXC container using the Debian 12 template.
+2. Ensure the network is bridged so Emacs can reach it.
+3. Run the `deploy/bare-metal/install.sh` script inside the container.

deploy/vms/debian/Vagrantfile

@@ -0,0 +1,22 @@
+Vagrant.configure("2") do |config|
+  config.vm.box = "debian/bookworm64"
+  config.vm.network "forwarded_port", guest: 9105, host: 9105
+
+  config.vm.provider "virtualbox" do |vb|
+    vb.memory = "1024"
+    vb.cpus = 2
+  end
+
+  config.vm.provision "shell", inline: <<-SHELL
+    apt-get update
+    apt-get install -y sbcl curl git ripgrep libsqlite3-dev build-essential
+    
+    # Setup for org-agent
+    mkdir -p /home/vagrant/org-agent
+    cp -r /vagrant/* /home/vagrant/org-agent/
+    chown -R vagrant:vagrant /home/vagrant/org-agent
+    
+    # Build binary natively
+    sudo -u vagrant bash -c "cd /home/vagrant/org-agent && ./deploy/bare-metal/install.sh"
+  SHELL
+end

deploy/vms/fedora/Vagrantfile

@@ -0,0 +1,21 @@
+Vagrant.configure("2") do |config|
+  config.vm.box = "fedora/39-cloud-base"
+  config.vm.network "forwarded_port", guest: 9105, host: 9105
+
+  config.vm.provider "virtualbox" do |vb|
+    vb.memory = "1024"
+    vb.cpus = 2
+  end
+
+  config.vm.provision "shell", inline: <<-SHELL
+    dnf install -y sbcl curl git ripgrep sqlite-devel make gcc
+    
+    # Setup for org-agent
+    mkdir -p /home/vagrant/org-agent
+    cp -r /vagrant/* /home/vagrant/org-agent/
+    chown -R vagrant:vagrant /home/vagrant/org-agent
+    
+    # Build binary natively
+    sudo -u vagrant bash -c "cd /home/vagrant/org-agent && ./deploy/bare-metal/install.sh"
+  SHELL
+end