athena.yaml 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657
  1. name: athena
  2. repo: https://github.com/athenaforhermes/athena
  3. sha: "3ef0dbddf18545f2a2d5b2e192dada16e3b0eda8"
  4. title: Athena
  5. description: "The local AI-app store for Hermes: browse a constantly growing catalogue of apps, install an app from any git repository, launch it, read its logs and stop it. It declares HF_TOKEN and GITHUB_TOKEN so Hermes offers to set them, and reads each one through Hermes' own secret route rather than scavenging another program's token store. An app is handed a credential only after you approve that app, as an environment variable for the life of its process - never written to disk and never sent anywhere by Athena itself. Apps run on your machine on loopback; third-party install scripts run as you, and the README states the network endpoints, the WSL/QEMU command paths and the GitHub publish path in full. The panel and the CLI are two doors into the same engine. Agent control is in active development. Disclosure — installs apps by cloning third-party git repositories and running their own install and launch scripts on your machine as you (each install and first launch asks through Hermes' approval prompt); provisions a pinned app engine from npm at setup after consent; hands HF_TOKEN / GITHUB_TOKEN to an app only after you approve that app, as an environment variable of its process; sends the GitHub token only to GitHub hosts; can manage WSL/QEMU machines and publish your store to a GitHub repository you name."
  6. maintainer: athenaforhermes
  7. tier: community
  8. category: platform
  9. version: "1.0.1"
  10. requires_hermes: ">=0.21.0,<0.23.0"
  11. docs_url: https://github.com/athenaforhermes/athena
  12. # `readme: true` makes the docs site render the plugin's own README from the
  13. # pinned commit - which is where the licence, the screenshots and the full
  14. # architecture live. It needs `repo` to be github.com (or gitlab.com), which it is.
  15. readme: true
  16. # `screenshots:` is deliberately absent until the repo has hosted assets: the
  17. # validator only accepts https URLs on github.com / raw.githubusercontent.com, so a
  18. # placeholder here would be an un-fetchable entry the moment it shipped. Three are
  19. # intended - a real panel, a running app, and a machine's screen - all cut from the
  20. # pinned commit once it is real. The licence is the repo's `LICENSE` (MIT).
  21. platforms: [windows]
  22. # Declared honestly: the engine, the app launches and the panel are tested on
  23. # Windows. Linux is expected to work (the engine is Node, the paths are POSIX-aware)
  24. # but has not been exercised, so the entry does not claim it.
  25. known_issues:
  26. - "Windows-tested only. The panel, the engine and app launches are exercised on Windows; Linux is expected to work but is untested, so the entry declares `platforms: [windows]`."
  27. - "The bundled engine is provisioned at setup from npm at a pinned version behind a consent step, so first setup needs network access to the npm registry; an offline machine cannot start the engine."
  28. - "An app whose menu marks no entry as default (FaceFusion, for example) is opened on its first runnable script - the install step on a fresh clone, the start action after. Athena falls back to the app's own menu rather than refusing to run it."
  29. capabilities:
  30. provides_tools:
  31. - athena_status
  32. - athena_apps
  33. - athena_search
  34. - athena_install
  35. - athena_launch
  36. - athena_stop
  37. - athena_logs
  38. - athena_store_detail
  39. - athena_publish
  40. - athena_delete
  41. - athena_fix
  42. - athena_report
  43. - athena_app_health
  44. - athena_models
  45. - athena_settings
  46. - athena_files
  47. - athena_space
  48. - athena_job
  49. - athena_capabilities
  50. - athena_generate
  51. - athena_runs
  52. - athena_schedule
  53. - athena_build_app
  54. - athena_machines
  55. provides_hooks: [pre_tool_call]
  56. provides_middleware: []
  57. requires_env: [HF_TOKEN, GITHUB_TOKEN]