Skip to content

Releases: ARPAHLS/OPSIE

Release list

0.3.80 XP — documentation, governance, and repository hardening

0.3.80 XP — documentation, governance, and repository hardening Latest
Latest

Choose a tag to compare

View all tags
@rosspeili rosspeili released this 12 May 13:22
0.3.80_XP
a4ec689

This release focuses on operator-facing documentation, ARPA-aligned repo hygiene, secret hygiene and safer defaults in code, and clearer cross-links to sibling ARPAHLS projects. Runtime behavior is intentionally largely unchanged except where noted for security and access control.

Documentation and README

  • Single canonical README.md (replacing the older long-form / Hub-style doc and the interim README2 pattern): centered header with ASCII logo, versioned pastel shields (Python 3.8+, Ollama 0.3+, llama3, nomic-embed-text, PostgreSQL 14+, ChromaDB 0.4+, Windows primary, ARPA), human-readable OPSIE positioning (terminal personality with agency and memory; daily driver for technical work; one session, own infra), and nav links.
  • Splash art: docs/opsiie-splash.png added locally (from ARPAHLS/OPSIE splash asset); image is shown under Quick start, not in the header, so the fold matches “clone → configure → run” flow.
  • docs/ library: command reference, architecture, boot/security, configuration, memory/RAG, voice, modules, prompts/SoulSig, troubleshooting, and docs index — aligned to 0.3.80 XP and actual code paths.
  • Cross-repository pointers in README and selected docs: Skillware, Hermes3 (Web3), Gatekeeper (biometric/emotion gateway), Rooms (arpahls/rooms) vs in-process /room, vic_aisaq_demo.
  • Repository layout table updated (including splash path, room.py note vs Rooms).

Governance files

Security and configuration hygiene

  • Removed committed .env from the working tree when secrets were present; operators must rotate any key that was ever exposed, including if historical Git objects might still contain them.
  • kun.py replaced with a sanitized template (Demo Operator, placeholder db_params, assets/enrollment.jpg path, kun.example.py still available for richer templates).
  • Hugging Face /imagine: removed hardcoded HF bearer token from OPSIIE_0_3_80_XP.py; inference uses HUGGINGFACE_API_KEY or HF_TOKEN via get_hf_image_headers() (documented in .env.example and docs).
  • load_dotenv() runs before from web3_handler import Web3Handler so .env is visible at Web3 import.
  • Removed unused hardcoded DB_PARAMS block from the main file (stale / misleading).
  • Access control: main input loop now treats 0x as master-only (with ask, markets, dna, send), closing a bypass where /0x could still reach handle_user_query for non-master users.
  • /status: fixed missing interpolation so call_name prints correctly in the reboot line.
  • .gitignore: tightened for secrets, venvs, caches, generated media patterns; !.env.example preserved.
  • .env.example: canonical env template (supersedes removed duplicate env.example filename where applicable).
  • assets/README.txt: explains biometric enrollment image expectations.

help.py and cross-doc behavior

  • /help room and main help listing: reference https://github.com/arpahls/rooms where useful for standalone room stacks.
  • docs/COMMANDS.md, docs/ARCHITECTURE.md, docs/MODULES.md, docs/MEMORY_AND_RAG.md, docs/PROMPTS_AND_SOULSIG.md: Rooms cross-references added with consistent wording (integrated /room vs arpahls/rooms).

Intentionally not shipped in-repo anymore

  • docs/GITHUB_ISSUE_BACKLOG.md removed — backlog items are not public product docs; maintain them as GitHub Issues or an internal tracker (see “Suggested follow-up issues” below).

Acknowledgements / fluid areas

  • Web3 import coupling remains: missing AGENT_PRIVATE_KEY or RPC URLs still exit() during web3_handler import. Documented; a future change may lazy-load Web3.
  • custom_words and similar may still use machine-specific absolute paths in OPSIIE_0_3_80_XP.py; safe to publish but not portable until centralized in a follow-up.
  • PostgreSQL “14+” in badges is a reasonable floor, not enforced by pip or application code.
  • ChromaDB in the stock build remains in-process / ephemeral unless operators add persistence separately.
  • README footer ARPA mark uses raw.githubusercontent.com/ARPAHLS/.github/... — if that asset moves, update the URL.
  • Room CSV samples under outputs/rooms/**: confirm whether they should be tracked on main; content looked non-secret in review but session logs are generally better ignored or not committed.

Suggested follow-up issues (create manually on GitHub — full detail retained here)

  1. Lazy-load Web3 handler to avoid import-time exit — Defer Web3Handler import or gate with OPSIIE_ENABLE_WEB3; when disabled, /0x should print configuration guidance instead of exiting at import. Files: OPSIIE_0_3_80_XP.py, web3_handler.py, docs/ARCHITECTURE.md, README.md. Acceptance: incomplete Web3 env + flag off reaches interactive loop; full env unchanged behavior.

  2. Deduplicate toggle_voice_mode and load_custom_sounds — Two definitions in OPSIIE_0_3_80_XP.py; merge to one; smoke voice paths. Files: OPSIIE_0_3_80_XP.py, docs/MODULES.md.

  3. Centralize media and output paths — Replace E:\Agents\... in custom_words etc. with paths.py or env-driven roots. Files: OPSIIE_0_3_80_XP.py, .env.example, docs/CONFIGURATION.md, README.md. Acceptance: no developer-specific absolute paths on default branch.

  4. Optional SKIP_FACIAL_RECOGNITION for CI / headless — Env flag with loud “dev only” warnings; default unchanged. Files: OPSIIE_0_3_80_XP.py, .env.example, SECURITY.md, docs/BOOT_AND_SECURITY.md.

  5. Smoke tests and optional CI — tests/test_smoke.py, mocked env or skip flags; document pytest in CONTRIBUTING.md; optional .github/workflows/ci.yml if org uses Actions.

  6. Chroma persistence option — Env for persistent client path or server URL; document SQL as source of truth. Files: OPSIIE_0_3_80_XP.py, docs/MEMORY_AND_RAG.md, .env.example.

  7. Hugging Face /imagine cold start UX — Retry/backoff on HTTP 503; message names cold start; link in docs/TROUBLESHOOTING.md.

  8. Set is_current_user after authentication — So /room intros use call_name without manual kun edits. Files: OPSIIE_0_3_80_XP.py, docs/CONFIGURATION.md.

  9. Git history scrub playbook pointer — If secrets ever hit remote history: BFG / git filter-repo + mandatory key rotation; short pointer in SECURITY.md.

  10. Hugging Face Hub README parity — If Hub needs YAML front matter / thumbnail, maintain README.hub.md or dual-branch sync so GitHub README stays canonical.

  11. Skillware spike — Optional /markets (or similar) behind flag using Skillware; design note in docs/ARCHITECTURE.md.

  12. Gatekeeper integration design — Reference architecture for delegating biometric decisions to Gatekeeper; docs or experimental branch.

What to expect next

  • Stability: treat this drop as docs + safety defaults; expect the same runtime surface, with stricter master gating for /0x and stricter secret handling.
  • Next engineering passes (from the list above): Web3 lazy import, path centralization, and CI smoke are the highest leverage for contributors and forks.
  • Operators: after pull, copy .env.example → .env, fill keys, add assets/enrollment.jpg, replace kun.py template with real profiles locally, and confirm Ollama models (llama3, nomic-embed-text) are present.

Thanks

Contributors and operators who reported friction around import-time Web3 failure, readme drift, and secret handling — this release is aimed at lowering onboarding risk without pretending the stack is smaller than it is.

Built & maintained by ARPA Hellenic Logical Systems and collaborators.

Assets 2
Loading