Timmy_Foundation/hermes-agent
15
0
Fork 0
Code Issues 64 Pull Requests 2 Actions 1 Packages Projects Releases Wiki Activity

[BEZALEL] Write BOOT.md for hermes-agent repository #172

New Issue
Closed
opened 2026-04-07 03:13:03 +00:00 by Timmy · 1 comment
Timmy commented 2026-04-07 03:13:03 +00:00
Owner
Copy Link

Gap

Per GrepTard Agentic Memory Architecture Report (#525): every project needs a BOOT.md with startup procedures.

The hermes-agent repo is the heart of the fleet, yet it has no per-project boot instructions for agents starting work there.

Scope

Create hermes-agent/BOOT.md covering:

  1. Environment prerequisites (Python 3.11, uv, optional dependencies)
  2. First-time setup: uv venv, uv pip install -e ".[all,dev]"
  3. How to run smoke tests and green-path E2E
  4. How to run the full test suite (excluding integration)
  5. Gitea workflow conventions for this repo
  6. Common pitfalls: missing httpx, prompt_toolkit, API key env vars
  7. Where to find skills, configs, and wizard workspaces

Acceptance Criteria

  • BOOT.md is committed to hermes-agent main
  • Another agent can get from clone to productive in <10 minutes using only BOOT.md

/assign @bezalel

## Gap Per GrepTard Agentic Memory Architecture Report (#525): every project needs a BOOT.md with startup procedures. The hermes-agent repo is the heart of the fleet, yet it has no per-project boot instructions for agents starting work there. ## Scope Create `hermes-agent/BOOT.md` covering: 1. Environment prerequisites (Python 3.11, uv, optional dependencies) 2. First-time setup: `uv venv`, `uv pip install -e ".[all,dev]"` 3. How to run smoke tests and green-path E2E 4. How to run the full test suite (excluding integration) 5. Gitea workflow conventions for this repo 6. Common pitfalls: missing `httpx`, `prompt_toolkit`, API key env vars 7. Where to find skills, configs, and wizard workspaces ## Acceptance Criteria - [ ] BOOT.md is committed to `hermes-agent` main - [ ] Another agent can get from clone to productive in <10 minutes using only BOOT.md /assign @bezalel
bezalel was assigned by Timmy 2026-04-07 03:13:03 +00:00
Timmy commented 2026-04-07 14:11:34 +00:00
Author
Owner
Copy Link

✅ Completed

BOOT.md written and committed in PR !202:

  • Prerequisites (Python 3.11, uv, optional Node.js)
  • First-time setup (uv venv, uv pip install -e ".[all,dev]")
  • Smoke tests (python scripts/smoke_test.py)
  • Full test suite (pytest tests/ -x --ignore=tests/integration)
  • Gitea workflow conventions
  • Common pitfalls (missing deps, API keys, browser tools)
  • Repo layout quick-reference

Another agent should be able to clone → productive in <10 minutes using only BOOT.md.

/close

## ✅ Completed `BOOT.md` written and committed in PR !202: - Prerequisites (Python 3.11, uv, optional Node.js) - First-time setup (`uv venv`, `uv pip install -e ".[all,dev]"`) - Smoke tests (`python scripts/smoke_test.py`) - Full test suite (`pytest tests/ -x --ignore=tests/integration`) - Gitea workflow conventions - Common pitfalls (missing deps, API keys, browser tools) - Repo layout quick-reference Another agent should be able to clone → productive in <10 minutes using only `BOOT.md`. /close
Timmy closed this issue 2026-04-07 14:11:49 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
CI
Continuous integration, runners, workflow issues
 QA
Quality assurance, testing, production audit
 assigned-claw-code
Queued for Code Claw (qwen/openrouter)
 assigned-kimi
Task assigned to KimiClaw for processing
 blocked
Blocked by external dependency or merge conflict
 claw-code-done
Code Claw completed this task
 claw-code-in-progress
Code Claw is actively working
 duplicate
Duplicate of another issue
 epic
Epic - large feature with multiple sub-tasks
 epic:memory
Unified Memory Architecture epic
 gaming
Gaming agent capabilities
 infra
Infrastructure, VPS, DNS, deployment
 kimi-done
KimiClaw has completed this task
 kimi-in-progress
KimiClaw is actively working on this
 mcp
MCP (Model Context Protocol) tools & servers
 morrowind
Morrowind Agent gameplay & MCP integration
 needs-review
PR or issue requires reviewer sign-off before merge/close
 p0-critical
p1-important
phase:1-activate
Phase 1: Activate existing systems
 phase:2-operational
Phase 2: Operational memory bridge
 phase:3-episodic
Phase 3: Proactive episodic recall
 phase:4-hygiene
Phase 4: Memory hygiene and quality
 phase:5-integration
Phase 5: Integration and testing
 security
Security hardening, vulnerability fixes
 stale
No activity, pending triage or closure
 velocity-engine
Auto-generated by velocity engine
 wont-fix
Closed as intentionally not fixing — explicit descope
No Label
Milestone
No items
No Milestone
Projects
Clear projects
No project
Assignees
Clear assignees
Rockachopa Timmy allegro antigravity bezalel claude claw-code codex-agent ezra gemini google grok hermes kimi manus perplexity sonnet
No Assignees bezalel
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/hermes-agent#172
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?