autobot

KO | EN

gitlite — search

#javascript #hacktoberfest #react #machine-learning #deep-learning #nodejs #windows #cli #kubernetes #awesome-list #security #mcp #openai #open-source

(★ 13)

:robot: Autobot is your nice and friendly bot. He is pluggable via Pub/Sub and written in @golang.

autobot 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Autobot

<a href='https://github.com/jpoles1/gopherbadger' target='_blank'>![gopherbadger-tag-do-not-edit](https://img.shields.io/badge/Go%20Coverage-42%25-brightgreen.svg?longCache=true&style=flat)</a>
![Github Action](https://github.com/andersnormal/autobot/workflows/Test%20%26%20Build/badge.svg)
[![Go Report Card](https://goreportcard.com/badge/github.com/andersnormal/autobot)](https://goreportcard.com/report/github.com/andersnormal/autobot)
[![License Apache 2](https://img.shields.io/badge/License-Apache2-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0)
[![Taylor Swift](https://img.shields.io/badge/secured%20by-taylor%20swift-brightgreen.svg)](https://twitter.com/SwiftOnSecurity)
[![Volkswagen](https://auchenberg.github.io/volkswagen/volkswargen_ci.svg?v=1)](https://github.com/auchenberg/volkswagen)

Autobot is your nice and friendly bot. He is here to save you from the :japanese_ogre: decepticons of #devops and other evil.

:see_no_evil: Contributions are welcome.

## Features

* Plugable architecture via [Pub/Sub Plugins](https://github.com/andersnormal/autobot/tree/master/pkg/plugins)
* Message queue for the bot inbox /outbox via embedded [NATS Streaming](https://github.com/nats-io/stan.go)
* [Protobuf](/proto/plugin.proto) for unified messages
* Plugins (e.g. Slack) but many more that you can build
* Uses [CloudEvents](https://cloudevents.io/) in Kafka to wrap messages

## Purpose

We build Autobot to be a scalable and pluggable tool for creating any kind of bot or chat operations tool. We choose [NATS](https://nats.io/) + [NATS Streaming Server](https://github.com/nats-io/nats-streaming-server) as the foundation because it is natual to use a log-based storage for any kind of messaging system. But also because it can be embedded. Embedding the storage into the server makes it much easier to have Autobot up and running.

Because we use a message queue as foundation we can build any kind of plugins via Pub/Sub on top of it. [NATS](https://nats.io) uses the [Raft Algoritm](https://raft.github.io/) for replication, which also means that our server uses replication and can be highly available. This is really create for large-scale systems, archiving and auditing (we may think about end to end encryption later). Again, the intention for Autobot was to have this run in production at scale.

## Architecture

Autobot is made of a [server](/server) and [plugins](/plugins). The server starts an embedded [Nats Streaming Server](https://github.com/nats-io/nats-streaming-server). The plugins subscribe and publish message to the provided queues. They can be run in their custom Docker containers. The plugins are started with an environment that exposes two channels for publishing and subscribing to messages and some more information. The [plugins](/pkg/plugins) package exposed functions to subscribe to the `inbox` channel, which should be used to publish messages from message services and `outbox` which should publish to these services (e.g. [Slack](https://slack.com) or [Microsoft Teams](https://products.office.com/microsoft-teams/free)).

<pre>
    Slack /                                                                
 Microsoft Teams               +-----------------------------------+    
        ^                    +-|---------------------------------+ |    
        |                    | |            Server               | |    
        |                    | | +---------------+               | |    
 +------|---------\          | | |     NATS      |               | |    
 |   Plugin    |   -----\    | | |               |               | |    
 +-------------<-\       -----\| |+-------------+|               | |    
                  ----\    ------->   Inbox     ||               | |    
                   -------\  | | |+-------------+|               | |    
 +-------------<--/        ----\ |+-------------+|               | |    
 |   Plugin    |         --------->   Outbox    ||               | |    
 +----------------------/    | | |+-------------+|               | |    
                             | | +---------------+               | |    
                             | +-----------------------------------+    
                             +-----------------------------------+  
</pre>

### Clustering

NATS Streaming Server supports [clustering](https://nats-io.github.io/docs/nats_streaming/clustering/clustering.html) and data replication. Because Autobot embedds the streaming server it supports clustering as the mechanism for high availability. Autobot supports the two modes of clustering. We recommend the "auto" mode in which you specify the list of peers to each started node. They elect a leader and start the replication. Because it uses the [RAFT consensus algorithm](https://raft.github.io/) it needs an uneven number of peers in the cluster. 3 or 5 are sufficient.

```bash
# this create a cluster consiting of 3 nodes
docker-compose up
```

## Plugins

> [godoc.org](https://godoc.org/github.com/andersnormal/autobot/pkg/plugins) for writing plugins

The [plugins](https://godoc.org/github.com/andersnormal/autobot/pkg/plugins) package provides you a simplified interface to connect to the underlying [NATS](https://nats.io) server. You can subscribe and publishe to the `autobot.inbox` and `autobot.outbox` topics. Also it provides you with an easy interface to the messages. It is actually the place where much of the :sparkles: happens.

There are some example plugins which demonstrate the capabilities of Autobot.

* [Slack](https://github.com/andersnormal/autobot-plugin-slack)
* [Hello World](https://github.com/andersnormal/autobot-plugin-hello-world)

Plugins are run on their own. They are not controlled by the server. Autobot uses pub/sub to be pluggable.

Plugins can be either configured by the automatically exposed command line parameters or the prefixed environment variables. A plugin can use the provided and automatically populated environment from the [runtime](https://godoc.org/github.com/andersnormal/autobot/pkg/plugins/runtime). They use these environment variables to populated the runtime environment.

* `AUTOBOT_CLUSTER_URL`
* `AUTOBOT_CLUSTER_ID`
* `AUTOBOT_INBOX`
* `AUTOBOT_OUTBOX`
* `AUTOBOT_LOG_FORMAT`
* `AUTOBOT_LOG_LEVEL`

Example for the [Slack Plugin](https://github.com/andersnormal/autobot-plugin-slack):

```bash
SLACK_TOKEN=
AUTOBOT_CLUSTER_ID=autobot
AUTOBOT_CLUSTER_URL=nats://controller:4222
AUTOBOT_LOG_FORMAT=json
AUTOBOT_LOG_LEVEL=info
AUTOBOT_DEBUG=true
AUTOBOT_VERBOSE=true
```

There are two log formats supported `text` (default) and `json`. The log levels reflect the [logrus](https://github.com/sirupsen/logrus/blob/4f5fd631f16452fbd023813c1eb7dbd67130cb0c/logrus.go#L93) levels.

## Example

> The images are hosted on [Docker Hub](https://cloud.docker.com/u/andersnormal/repository/docker/andersnormal/autobot)
> you should change [.env](/.env) for your specific setup (very much only add a valid Slack Bot [Token](https://api.slack.com/docs/token-types))

This example uses [Docker Compose](https://docs.docker.com/compose/) and you will need a [Slack Bot](https://api.slack.com/bot-users) Token (e.g. xob-xxxx).

You should provide this token in the [.env](https://github.com/andersnormal/autobot/.env) file. Which is used to configure the plugins containers. Because Autobot is using pub/sub to communicate with its plugins they can be run independently in their own containers. [Anders Normal](https://cloud.docker.com/u/andersnormal) contains the plugins in containers.

```bash
# start the containers
docker-compose up
```

You should now see your Slack Bot connect in your Workspace and can send him a direct message which he will respond to with `hello world`.

:raised_hands: you have your own bot running.

Next, you can write your own [plugins](https://godoc.org/github.com/andersnormal/autobot/pkg/plugins). It would be really cool if you could contribute it.

## Development

> we use [Picasso](https://github.com/andersnormal/picasso) for build automation

You can build the [Protobuf](/proto) by running

```bash
picasso proto
```

We use a specific version of proto package generator. In order to build it with this version you will have to install it as follows

```bash
GIT_TAG="v1.2.0" # change as needed
go get -d -u github.com/golang/protobuf/protoc-gen-go
git -C "$(go env GOPATH)"/src/github.com/golang/protobuf checkout $GIT_TAG
go install github.com/golang/protobuf/protoc-gen-go
```

The server is build by running

```bash
picasso build/server
```

The options of the server can be shown by `./server --help`.

## License

[Apache 2.0](/LICENSE)

autobot

autobot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

autobot

autobot 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README