64 lines
1.9 KiB
Markdown
64 lines
1.9 KiB
Markdown
# Asjon ROBOT
|
|
|
|
Asjon è un chat bot creato usando l'[Hubot][hubot] framework.
|
|
|
|
[hubot]: http://hubot.github.com
|
|
|
|
## Usare Asjon
|
|
|
|
Asjon è sempre online su Telegram con l'username `Asjon ROBOT`
|
|
|
|
## Sviluppare Asjon
|
|
|
|
Puoi testare asjon seguendo queste istruzioni, però alcuni componenti necessitano
|
|
di [variabili d'ambiente](#configuration) particolari per essere configurati
|
|
correttamente (ad esempio i dati di accesso al registro elettronico per l'agenda)
|
|
|
|
### Dipendenze
|
|
|
|
Asjon necessita di:
|
|
|
|
- `node` e `npm`
|
|
- `redis` se si vuole salvare la sua memoria in maniera persistente
|
|
- `phantomjs` per utilizzare il modulo agenda/compiti
|
|
|
|
### Installazione
|
|
|
|
1. installare le dipendenze. Su arch linux: `pacman -S python2 nodejs phantomjs redis`
|
|
1. clonare questa repo
|
|
1. lanciare `npm install` (__Attenzione:__ usare `PYTHON=python2 npm install` su arch linux!) per installare tutte le dipendenze npm
|
|
1. se vuoi che Asjon conservi i ricordi tra una sessione e l'altra, avvia redis (su arch linux: `systemctl start redis`)
|
|
1. lanciare `bin/hubot` per testare il bot. Per usare le variabili d'ambiente usare
|
|
la sintassi di bash `VARIABILE=valore VAR2=valore2 bin/hubot`.
|
|
|
|
### Testing
|
|
|
|
Puoi avviare asjon eseguendo
|
|
|
|
$ bin/hubot
|
|
|
|
Se tutto va bene dovrebbe comparire una cosa del genere:
|
|
|
|
[Sat Feb 28 2015 12:38:27 GMT+0000 (GMT)] INFO Using default redis on localhost:6379
|
|
asjon>
|
|
|
|
Puoi interagire con asjon scrivendo `asjon help` o qualsiasi altro suo comando.
|
|
|
|
### Scripting
|
|
|
|
Gli script di Asjon sono nella cartella `scripts`.
|
|
La [Scripting Guide](scripting-docs) di hubot è molto utile per imparare come funzionano
|
|
|
|
[scripting-docs]: https://github.com/github/hubot/blob/master/docs/scripting.md
|
|
|
|
### Hosting
|
|
|
|
Asjon può essere hostato come un qualsiasi Hubot, ma richiede phantomjs per alcune funzioni.
|
|
|
|
Il ramo `master` di Asjon è sempre hostato online ed è accessibile tramite telegram all'username
|
|
Asjon ROBOT.
|
|
|
|
## Licenza
|
|
|
|
Hubot e Asjon sono distribuiti sotto la MIT License
|