beehive

Sarang lebah

Beehive adalah sistem acara dan agen, yang memungkinkan Anda membuat agen Anda sendiri yang melakukan tugas otomatis yang dipicu oleh acara dan filter. Ini modular, fleksibel dan sangat mudah diperpanjang bagi siapa pun. Ini memiliki modul (kami menyebutnya sarang ), sehingga dapat berinteraksi dengan, berbicara, atau mengambil informasi dari Twitter, Tumblr, Email, IRC, Jabber, RSS, Jenkins, Hue - untuk menyebutkan beberapa saja. Lihatlah daftar lengkap sarang yang tersedia di wiki kami.

Menghubungkan modul -modul itu satu sama lain memungkinkan Anda membuat agen yang sangat berguna.

Berikut adalah beberapa contoh hal yang bisa dilakukan Beehive untuk Anda:

• Posting ulang tweet di blog Tumblr Anda
• Meneruskan pesan obrolan yang masuk ke akun email Anda
• Nyalakan sistem pemanas jika suhu turun di bawah nilai tertentu
• Jalankan bot IRC Anda sendiri yang memungkinkan Anda memicu build di Jenkins CI
• Kontrol Sistem Pencahayaan Hue Anda
• Beri tahu Anda saat harga saham turun di bawah nilai tertentu

Instalasi

Paket & Binari

• Arch Linux: Beehive (AUR)
• Linux Static 64bit
• Linux Static ARMV6
• MacOS 64bit
• Windows 64bit

Anda dapat menemukan lebih banyak rilis resmi di sini.

Alat penempatan

• Docker: docker run --name beehive -d -p 8181:8181 fribbledom/beehive
• Semu

Dari sumber

Beehive membutuhkan go 1.13 atau lebih tinggi. Pastikan Anda memiliki lingkungan yang bekerja. Lihat Instruksi Instal.

Cara yang disarankan adalah mengambil sumber dan menjalankan.

 git clone --recursive https://github.com/muesli/beehive.git
cd beehive
make

Anda dapat membangun dan menginstal biner beehive seperti binari lainnya di luar sana ( go get ) tetapi Anda harus memastikan sarang lebah dapat menemukan aset (gambar, javascript, css, dll). Lihat bagian Pemecahan Masalah/Catatan untuk detail tambahan.

Jalankan beehive --help untuk melihat daftar lengkap opsi.

Konfigurasi

Pikirkan sarang sebagai plugin kecil, memperluas kemampuan Beehive dengan peristiwa yang dapat Anda bereaksi dan tindakan yang dapat Anda jalankan.

Sama seperti contoh, ada plugin Twitter yang bisa

• Bereaksi terhadap seseorang yang Anda ikuti memposting tweet (acara)
• Posting tweet baru untuk Anda (suatu tindakan)
• ...

atau plugin RSS yang memungkinkan Anda

• Monitor RSS Feeds dan bereaksi pada item umpan baru (acara lain)

atau plugin email yang memberi Anda kemampuan untuk

• Kirim Email (Tindakan Lain)

Setiap sarang memungkinkan Anda menelurkan satu atau beberapa lebah di dalamnya, semuanya bekerja secara mandiri dari yang lain. Itu memungkinkan Anda untuk membuat instance plugin terpisah, misalnya satu email email untuk akun email pribadi Anda, dan satu lagi untuk email kerja Anda.

Membuat lebah

Kedengarannya rumit? Tidak! Hanya untuk bersenang -senang, mari kita siapkan Beehive untuk mengirimi kami email setiap kali umpan RSS diperbarui. Mulailah beehive dan buka http: // localhost: 8181/di browser Anda. Perhatikan bahwa Beehive akan membuat file konfigurasi beehive.conf di direktori kerja saat ini, kecuali Anda menentukan file yang berbeda dengan opsi -config .

Catatan: Jika Anda membangun Beehive dengan go build alih -alih make Anda harus memulai beehive dari dalam direktori sumbernya agar dapat menemukan semua sumber daya untuk antarmuka admin. Juga lihat bagian Pemecahan Masalah & Catatan dari Readme ini.

Antarmuka admin akan memberi Anda daftar sarang yang tersedia. Kami perlu membuat dua lebah di sini, satu untuk umpan RSS dan satu untuk akun email Anda.

Menyiapkan rantai

Sekarang kita harus membuat rantai baru, yang akan menangani dua lebah yang baru saja kita buat. Pertama, kami memilih lebah & acara yang ingin kami bereaksi, lalu kami memilih lebah yang ingin kami lakukan. Acara RSS-BEE memberi kita seluruh rangkaian parameter yang dapat kita kerjakan: judul item umpan, tautan dan deskripsi antara lain. Anda dapat memanipulasi dan menggabungkan parameter ini dengan bahasa templating penuh yang Anda inginkan. Misalnya kami dapat mengatur konten email ke sesuatu seperti:

 Title: {{.title}} - Link: {{index .links 0}}

Setiap kali tindakan ini dieksekusi, Beehive akan menggantikan {{.title}} dengan parameter title acara RSS, yang merupakan judul item umpan yang diambilnya. Dengan cara yang sama {{index .links 0}} menjadi URL pertama dari array links acara ini.

Itu saja. Setiap kali RSS-Feed diperbarui, Beehive sekarang akan mengirimi Anda email! Sangat mudah untuk membuat berbagai lebah bekerja bersama dengan mulus dan melakukan hal -hal cerdas untuk Anda. Cobalah sendiri!

Anda dapat menemukan lebih banyak informasi tentang cara mengkonfigurasi lebah dan contoh di wiki kami.

Pemecahan Masalah & Catatan

Antarmuka web dan sumber daya lainnya tertanam dalam biner secara default. Saat menggunakan make noembed , Beehive mencoba menemukan file -file tersebut di direktori kerja saat ini, jadi saat ini disarankan untuk memulai Beehive dari dalam repositori git -nya, jika Anda berencana untuk menggunakan antarmuka web.

Jika Anda masih tidak dapat mencapai antarmuka web, periksa apakah direktori config di repositori git kosong. Jika itu masalahnya, pastikan submodul GIT diinisialisasi dengan menjalankan git submodule update --init .

Antarmuka web belum memerlukan otentikasi. Beehive secara default hanya menerima semua koneksi dari perangkat loopback.

Jika Anda ingin mengikat sarang lebah ke antarmuka/alamat yang berbeda, jalankan sarang lebah dengan parameter -bind dan -canonicalurl . Misalnya:

 beehive -bind "192.168.0.1:8181" -canonicalurl "http://192.168.0.1:8181"

atau

 docker run --name beehive -d -e CANONICAL_URL="http://192.168.0.1:8181" -p 8181:8181 fribbledom/beehive

Perkembangan

Butuh bantuan? Ingin meretas sarang Anda sendiri? Bergabunglah dengan kami di IRC (IRC: //Freenode.net/#beehive) atau Gitter. Ikuti lebah di Twitter!