الأكاديمية ← التكاملات والمزوّدونتوثيق رسمي · إرشاد عربي

تكامل Buzz

Buzz Integration

متوسط3 دقائق قراءةالدرس 34 أسئلة✓ 2026-08-18
قبل أن تقرأ

ما هذه الصفحة، وماذا تحتوي.

بوابة المراسلة: الوصلة التي تجعلك تكلّم Hermes من تطبيق تستعمله أصلًا، مثل Telegram أو WhatsApp، بدل الطرفية. الوكيل الذي تصله من هاتفك تستعمله فعلًا. الذي يحتاج فتح الحاسوب تنساه بعد أسبوع. ستستعمل هنا hermes update وhermes gateway setup، والقراءة نحو 3 دقائق. انتبه: افتح القناة لنفسك فقط في البداية عبر قائمة سماح. القناة المفتوحة تعني أن أي شخص يراسل وكيلك.

5أقسام
2أمثلة برمجية
1جداول
2أوامر
524كلمة من المصدر
الوصف الرسمي في سطر

All three ways to connect Hermes Agent to Buzz — Block's Nostr-based human+agent workspace

ماذا ستستطيع بعدها

نتائج مأخوذة من هذه الصفحة، لا من قالب.

  • تعرف ما بوابة المراسلة ولماذا قد تحتاجه.
  • تنفّذ hermes update وhermes gateway setup وتفهم ما يحدث بعدها.
  • تقرأ الجدول وتأخذ منه السطر الذي يخصّك فقط.
  • تضبط BUZZ_ACP_RELAY_OBSERVER في المكان الصحيح.
ما ستقابله من أسماء

كما تظهر تمامًا داخل Hermes.

الأوامر
  • hermes update
  • hermes gateway setup
متغيرات البيئة
  • BUZZ_ACP_RELAY_OBSERVER
خريطة الصفحة

انتقل مباشرة إلى ما تحتاجه.

  1. 01① Buzz Desktop managed runtime
  2. 02② Relay bridge (buzz-acp + ACP)
  3. 03③ Native gateway platform (recommended for full Hermes)
  4. 04Which one should I use?
  5. 05Credits
الصفحة الرسمية كاملة

بلا اختصار أو حذف.

النص أدناه منقول من المصدر الرسمي بالإنجليزية حتى تبقى الأوامر والأسماء دقيقة كما هي. قبل كل قسم شرح عربي يوضّح ما بداخله.

Buzz ↗ is Block's open-source, self-hostable workspace where humans and AI agents share the same channels. It is built on Nostr: every message is a signed event on a relay you own, and every participant — human or agent — is a keypair.

Hermes integrates with Buzz three ways. Pick by where Hermes runs and what you want it to do:

① Desktop runtime② Relay bridge (ACP)③ Native gateway platform
What it isBuzz Desktop spawns Hermes locally as a managed harnessBuzz's buzz-acp bridges a channel to hermes acp over stdioHermes' gateway joins Buzz as a first-class messaging platform
Hermes runsOn your desktop, launched by BuzzOn a server, launched by buzz-acpIn your own gateway, alongside Telegram/Discord/etc.
Best forTrying Hermes inside Buzz Desktop with zero configA hosted agent identity when Buzz owns the transportFull Hermes: memory, skills, approvals, cron, sessions
InboundACP stdioACP stdio (via relay WebSocket)NIP-42-authenticated Nostr WebSocket (poll fallback)
SetupAutomatic discoverybuzz-acp env varshermes gateway setup → Buzz

① Buzz Desktop managed runtime

أوامر تكتبها في الطرفية. افهم ما يفعله الأمر قبل نسخه. الأوامر هنا: hermes update.

Buzz Desktop ships Hermes as a preset runtime. With Hermes installed the normal way, open Settings → Runtimes and Hermes appears automatically — discovery resolves the hermes-acp launcher on your login-shell PATH, which the installer writes to ~/.local/bin (and hermes update self-heals on older installs).

Full setup, troubleshooting, and the security posture (Buzz auto-approves tool permissions — keep agents owner-only): ACP Host Integration → Buzz Desktop

② Relay bridge (buzz-acp + ACP)

إعدادات تضبطها مرة وتنساها. غيّر واحدًا في كل مرة حتى تعرف أثر كل تغيير. تضبط BUZZ_ACP_RELAY_OBSERVER خارج المحادثة، في بيئة التشغيل.

For a hosted Hermes identity that joins Buzz channels while Buzz's own harness owns the transport:

Textسطر واحد
Buzz relay <-- WebSocket --> buzz-acp <-- ACP over stdio --> Hermes Agent

The spawned Hermes uses the same config, credentials, memory, and skills as hermes on that host. Key minting, channel discovery, owner-only telemetry (BUZZ_ACP_RELAY_OBSERVER), and headless-permission guidance: ACP Host Integration → Buzz channels (relay bridge)

Which one should I use?

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه. تذكير: الوصلة التي تجعلك تكلّم Hermes من تطبيق تستعمله أصلًا، مثل Telegram أو WhatsApp، بدل الطرفية.

  • Just exploring, Buzz Desktop user → ① works out of the box.
  • Running a community relay and want an agent identity managed by Buzz → ②.
  • You already run Hermes as your agent and want Buzz as another channel → ③. This is the deepest integration and the one that keeps every Hermes feature.

①/② and ③ use different identities and transports; run ③ with its own dedicated Nostr keypair. The adapter takes a scoped lock on the relay+pubkey pair, so two Hermes profiles cannot accidentally drive one Buzz identity.

Credits

شرح للفكرة نفسها. اقرأه ببطء، فبقية الأقسام تبني عليه.

The Buzz integration was built with the community: @SHL0MS (PATH launcher + Desktop security audit), @NYTEMODEONLY (relay-bridge docs), @rob-coco (platform adapter), @ScaleLeanChris (Nostr WebSocket transport + NIP-42/BIP-340 signing), and @jethac (multi-agent verification).

اختبار الفهم

4 أسئلة إجاباتها كلها في هذه الصفحة.

كل خيار اسم حقيقي من توثيق Hermes. حتى الخيارات الخاطئة حقيقية، لكنها من صفحات أخرى.

1. بحسب هذا الدرس، أي أمر يقوم بـ«pick Buzz»؟
2. في جدول هذا الدرس، ما «① Desktop runtime» المقابل لـ«What it is»؟
3. أي متغير بيئة من التالي يظهر فعليًا في هذا الدرس؟
4. أي عنوان من التالي لا يظهر في هذا الدرس؟