Skip to content
Back to search

zero-human-companies

Skills, agent configs and scripts for a Paperclip company run by Hermes agents. Companion to the book Zero-Human Companies. Educational, not business advice. From youcanbuildthings.com.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/regardo911--zero-human-companies/badge.svg)](/listings/regardo911--zero-human-companies)

HTML

<a href="/listings/regardo911--zero-human-companies"><img src="/api/listings/regardo911--zero-human-companies/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 107 lines
  1. # Zero-Human Companies: the files
  2. **Hermes agents finish the issues in a Paperclip company. Here are the files from the book that build it.**
  3. Companion to the book *Zero-Human Companies* from [youcanbuildthings.com](https://youcanbuildthings.com).
  4. The files the book has you type in, laid out by chapter, so you copy instead of retype. **Hermes** does the work (chapter 4). **Paperclip** hands it issues and tracks the cost (chapter 7). A **skill** is a `SKILL.md` Hermes reads before a task (chapter 5). An **agent config** is the JSON you paste into Paperclip to hire a Hermes agent (chapter 8). Pick a starting point below.
  5. [![CI](https://github.com/regardo911/zero-human-companies/actions/workflows/ci.yml/badge.svg)](https://github.com/regardo911/zero-human-companies/actions/workflows/ci.yml)
  6. [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
  7. [![Educational, not business advice](https://img.shields.io/badge/read-disclaimer-orange.svg)](DISCLAIMER.md)
  8. ![Poster. A Paperclip company where Hermes agents finish the issues. Left, what you build in chapters 8, 10 and 11. Right, the files: 11 skills, 11 agent configs, SOUL.md and memory examples, 4 scripts, monthly-report.sh and revenue.csv. Bottom: run ./chapters/01-setup-check/check-prereqs.sh first.](docs/images/hero.png)
  9. ## Start here
  10. ```bash
  11. git clone https://github.com/regardo911/zero-human-companies.git
  12. cd zero-human-companies
  13. ```
  14. ### "I'm starting the book and have nothing installed"
  15. ```bash
  16. ./chapters/01-setup-check/check-prereqs.sh
  17. ```
  18. It prints the version of node, python3, curl, git, jq and bc, or `missing` plus the install line. Read-only. Then turn to chapter 4.
  19. ### "Hermes is installed"
  20. ```bash
  21. ./install.sh
  22. ```
  23. Copies the book's 11 skills into `~/.hermes/skills/personal/`. A skill folder you already have is left alone, so your own edits survive. Then `hermes skills list` shows them.
  24. ### "My Paperclip company is running"
  25. ```bash
  26. chapters/10-five-businesses/research-agency/run.sh my-brief.txt my-questions.txt
  27. ```
  28. Write your brief and questions first: copy `example-brief.txt` and `example-questions.txt` from that folder and change them. Export your agent ids as the [chapter 10 README](chapters/10-five-businesses/) shows. The script creates the Research Agency's issues from your files, runs each agent's heartbeat, and stops with the delivery issue waiting for your approval. It asks you to type `yes` before it spends anything. Want something smaller first? The [chapter 8 scripts](chapters/08-compose/) run a two-issue chain on one agent.
  29. ### "I finished the book, I just want the files"
  30. Use the table below.
  31. ## Where each file goes
  32. | Chapter | In this repo | Where it goes |
  33. |---|---|---|
  34. | 5 | `chapters/05-skills/standup-notes/`, `my-research-workflow/` | `~/.hermes/skills/personal/<name>/` (`./install.sh` does it) |
  35. | 6 | `chapters/06-memory/SOUL.example.md` | `~/.hermes/SOUL.md`, after you rewrite it for yourself |
  36. | 6 | `chapters/06-memory/memories/USER.md` | `~/.hermes/memories/USER.md` |
  37. | 6 | `chapters/06-memory/memories/projects/research-agency.md` | `~/.hermes/memories/projects/research-agency.md` |
  38. | 8 | `chapters/08-compose/agents/*.json` | Paperclip dashboard: Agents, Add Agent. The `adapterConfig` block goes in Adapter Config |
  39. | 10 | `chapters/10-five-businesses/<business>/agents/*.json` | Same place, one agent per file |
  40. | 10 | `chapters/10-five-businesses/skills/<name>/` | `~/.hermes/skills/personal/<name>/` (`./install.sh` does it) |
  41. | 11 | `chapters/11-revenue/monthly-report.sh` | `~/bin/monthly-report.sh` |
  42. | 11 | `chapters/11-revenue/revenue.csv` | Wherever you keep your books. One row per payment |
  43. To print just the part that goes in Adapter Config: `jq .adapterConfig chapters/08-compose/agents/research-worker.json`.
  44. ## Chapter map
  45. | Folder | What you build | The command | What success looks like |
  46. |---|---|---|---|
  47. | [01-setup-check](chapters/01-setup-check/) | A checked machine | `./chapters/01-setup-check/check-prereqs.sh` | Six version lines, exit 0 |
  48. | [05-skills](chapters/05-skills/) | Your first hand-written skill | `hermes -s standup-notes` | A three-line Yesterday / Today / Blockers note |
  49. | [06-memory](chapters/06-memory/) | An agent that knows who you are, and a backup | `chapters/06-memory/backup.sh` | `wrote ./hermes-knowledge-<date>.tar.gz` |
  50. | [08-compose](chapters/08-compose/) | One Hermes agent finishing Paperclip issues in order | `chapters/08-compose/chain-path-b.sh <company-id> <agent-id> "<title>" "<title>"` | Both issues print `done` |
  51. | [10-five-businesses](chapters/10-five-businesses/) | One of five business teams | `chapters/10-five-businesses/research-agency/run.sh <brief> <questions>` | The delivery issue sits in `in_review`, waiting for you |
  52. | [11-revenue](chapters/11-revenue/) | Your monthly numbers | `monthly-report.sh <YYYY-MM> <company-id>` | Issues completed, agent cost, revision rate |
  53. Chapters 2, 3, 4, 7, 9 and 12 are explanation, or commands you type straight from the book, so they get no folder. Where the book and the tools have drifted apart, [BOOK-FIXES.md](BOOK-FIXES.md) has the working version and the output that proves it.
  54. ## How it fits together
  55. Paperclip runs the company: issues, heartbeats, costs, approvals. Hermes does the work, with its skills and memory. The `hermes_local` adapter that ships inside Paperclip joins them, so a heartbeat starts a Hermes run on an issue and the result lands back in Paperclip. The skills and memory files here go to Hermes; the agent configs go to Paperclip.
  56. ## What it needs
  57. - node, python3, curl, git, jq and bc, the six `check-prereqs.sh` checks. `install.sh`, `backup.sh` and the tests run on those alone, offline.
  58. - `bash tests/run.sh` runs offline in a throwaway home. It parses every agent config, matches each skill's `name:` to its folder, and checks each `--skills` name against this repo plus the two Hermes ones it assumes (`systematic-debugging`, `jupyter-live-kernel`). It runs `install.sh`, `backup.sh` and `monthly-report.sh` on made-up data and confirms the paid scripts stop without a typed `yes`.
  59. - The chapter 8, 10 and 11 scripts need your own Paperclip server (chapter 7), Hermes (chapter 4), and a funded model provider or Ollama. Heartbeats cost real money, so those scripts ask first. They pass `bash -n` and shellcheck here. Your server is their first real run.
  60. ## Configuration
  61. `chain-path-b.sh`, `approval-gate.sh`, `run.sh` and `monthly-report.sh` read `PAPERCLIP_API_URL` and `PAPERCLIP_API_KEY` from your shell. Chapter 8 shows where they come from:
  62. ```bash
  63. npx paperclipai agent local-cli <agent-ref> -C <company-id> --no-install-skills
  64. ```
  65. It prints four `export` lines. Paste them into the shell you run the scripts from. Your provider keys stay in `~/.hermes/.env`, where chapter 4 put them.
  66. ## Contributing
  67. Found a command that no longer matches the tool's `--help`? See [CONTRIBUTING.md](CONTRIBUTING.md).
  68. ## License
  69. MIT. See [LICENSE](LICENSE).
  70. Educational software, provided as is, with no warranty.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.