Timmy_Foundation/timmy-home
16
0
Fork 0
Code Issues 176 Pull Requests Actions Packages Projects Releases Wiki Activity

Write Timmy VPS provisioning script (fresh box to running wizard) #75

New Issue
Closed
opened 2026-03-30 15:06:38 +00:00 by Timmy · 1 comment
Timmy commented 2026-03-30 15:06:38 +00:00
Owner
Copy Link

Objective

Write a single provisioning script that takes a fresh Ubuntu 22.04+ VPS and sets up everything Timmy needs to operate as a sovereign local-first wizard.

What the script should install and configure

Inference

  • Build llama.cpp from source (CPU-only, with OpenBLAS or similar)
  • Download model weights (Hermes-3 8B GGUF as default, configurable)
  • Set up llama-server as a systemd service on port 8081
  • Configure with: -c 8192 -np 1 --jinja -ngl 0 (CPU mode)

Agent Harness

  • Clone timmy-home repo from Gitea
  • Set up Python venv with dependencies
  • Install Hermes agent framework (or minimal equivalent)
  • Configure provider to point at localhost:8081

System Services

  • llama-server.service (inference)
  • timmy-agent.service (agent harness)
  • syncthing.service (shared folder, call the script from issue above)
  • timmy-health.service (health check daemon)

Directory Structure

~/timmy/
  soul/          # SOUL.md, OPERATIONS.md, etc
  scripts/       # operational scripts
  logs/          # agent logs, JSONL
  shared/        # syncthing mount
  models/        # GGUF weights

Security

  • UFW firewall: allow SSH, 8081 (local only), 22000 (syncthing)
  • No inference port exposed to internet
  • SSH key only (document, don't enforce)

Deliverables

  1. scripts/provision-timmy-vps.sh — the main script
  2. configs/llama-server.service — systemd unit
  3. configs/timmy-agent.service — systemd unit
  4. docs/VPS_SETUP.md — manual steps + troubleshooting

Acceptance Criteria

  • Script runs unattended on a fresh Ubuntu 22.04 VPS
  • After completion, curl localhost:8081/health returns OK
  • Agent can execute a simple tool-call task against local llama-server
  • All services survive reboot
  • Idempotent (safe to run twice)
## Objective Write a single provisioning script that takes a fresh Ubuntu 22.04+ VPS and sets up everything Timmy needs to operate as a sovereign local-first wizard. ## What the script should install and configure ### Inference - Build llama.cpp from source (CPU-only, with OpenBLAS or similar) - Download model weights (Hermes-3 8B GGUF as default, configurable) - Set up llama-server as a systemd service on port 8081 - Configure with: `-c 8192 -np 1 --jinja -ngl 0` (CPU mode) ### Agent Harness - Clone timmy-home repo from Gitea - Set up Python venv with dependencies - Install Hermes agent framework (or minimal equivalent) - Configure provider to point at localhost:8081 ### System Services - llama-server.service (inference) - timmy-agent.service (agent harness) - syncthing.service (shared folder, call the script from issue above) - timmy-health.service (health check daemon) ### Directory Structure ``` ~/timmy/ soul/ # SOUL.md, OPERATIONS.md, etc scripts/ # operational scripts logs/ # agent logs, JSONL shared/ # syncthing mount models/ # GGUF weights ``` ### Security - UFW firewall: allow SSH, 8081 (local only), 22000 (syncthing) - No inference port exposed to internet - SSH key only (document, don't enforce) ## Deliverables 1. `scripts/provision-timmy-vps.sh` — the main script 2. `configs/llama-server.service` — systemd unit 3. `configs/timmy-agent.service` — systemd unit 4. `docs/VPS_SETUP.md` — manual steps + troubleshooting ## Acceptance Criteria - [ ] Script runs unattended on a fresh Ubuntu 22.04 VPS - [ ] After completion, `curl localhost:8081/health` returns OK - [ ] Agent can execute a simple tool-call task against local llama-server - [ ] All services survive reboot - [ ] Idempotent (safe to run twice)
allegro was assigned by Timmy 2026-03-30 15:06:38 +00:00
allegro commented 2026-03-30 15:23:03 +00:00
Member
Copy Link

PR Ready

Full VPS provisioning script complete.

PR: http://143.198.27.163:3000/Timmy_Foundation/timmy-home/pulls/81

Tested on Allegro VPS - llama.cpp builds and runs correctly.

**PR Ready** Full VPS provisioning script complete. PR: http://143.198.27.163:3000/Timmy_Foundation/timmy-home/pulls/81 Tested on Allegro VPS - llama.cpp builds and runs correctly.
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
alembic
The Alchemical Vessel - Kimi-powered transformation
 architecture
Auto-created architecture label
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Dispatched to Kimi via OpenClaw
 auth-needed
auth-needed
 bizzalo
bizzalo
 blocker
blocker
 claw
Claw Code runtime (Rust)
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 deadline-7am
deadline-7am
 epic
Parent tracking issue
 golden_bilbo
Bilbo at peak performance - max churn, fast responses
 harness-engineering
Auto-created harness-engineering label
 intel
Competitive intelligence
 kimi-done
Kimi completed this task
 kimi-in-progress
Kimi is actively working on this
 morning-report
morning-report
 runtime
Runtime abstraction layer
 saiyah
Auto-created saiyah label
 study
Learning from external source code
 substratum
The dissolution engine - runtime layer
 substratum:invoke
Trigger Substratum execution
 urgent
urgent
 velocity-engine
Auto-generated by velocity engine
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
KimiClaw Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok groq hermes kimi manus perplexity
No Assignees allegro
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/timmy-home#75
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?