Awesome Open Source
Awesome Open Source

Olivia's character

💁‍♀️ Your new best friend


Twitter Follow

WebsiteDocumentationGetting startedIntroductionTranslationsContributorsLicense

⚠️ Please check the Call for contributors




Olivia is an open-source chatbot built in Golang using Machine Learning technologies. Its goal is to provide a free and open-source alternative to big services like DialogFlow.

You can chat with her by speaking (STT) or writing, she replies with a text message but you can enable her voice (TTS).

You can clone the project and customize it as you want using GitHub Try it on her website!

Why Olivia?

  • The only chatbot project in Go that could be modulable and customizable.
  • Using daily a privacy-friendly chatbot is great.
  • The Website is a Progressive Web Application, which means you can add it to your phone and it seems like a native app!

Getting started


Login to Github

To get a personal access token from Github go to Setings > Developer settings > Personal Access Tokens

Click on Generate new Token and name it you MUST have read and write packages ticked on. Then click Generate new token

Replace TOKEN with the Token that you just made.

$ export PAT=TOKEN

Login to Github (Note: change USERNAME to Gthub username)

$ echo $PAT | docker login -u USERNAME --password-stdin


docker installation

Pull the image from GitHub Packages

$ docker pull

Then start it

$ docker run -d -e PORT=8080 -p 8080:8080

You can just use the websocket of Olivia now.

To stop it, get the container id:

$ docker container ls
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS                    NAMES
311b3abb963a        olivia              "./main"            7 minutes ago       Up 7 minutes>8080/tcp   quizzical_mayer

and stop it

$ docker container stop 311b3abb963a 

The app will automatically check for res/datasets/training.json file which contains the save of the neural network. By default when you clone the repository from Github you have a stable save. If you want to train a new model just delete this file and rerun the app.


Clone the project via GitHub:

$ git clone [email protected]:olivia-ai/olivia.git

Then download the dependencies

$ go mod download

And run it

$ go run main.go

Frontend and Backend

To install the frontend and the backend together, please use the docker-compose.yml file:

$ docker-compose up

And all done!





Languages supported

  • English
  • Spanish
  • Catalan
  • French
  • German
  • Italian
  • Brazilian portuguese - not completed


The coverage of the translations is given here. To add a language please read the documentation for that.


docker installation


Please refer to the contributing file

Code Contributors

Thanks to the people who contribute to Olivia.


Financial Contributors

Become a financial contributor and help Olivia growth.

Contribute on the GitHub page of hugolgst ❤️


FOSSA Status

Made with ❤️ by Hugo Lageneste

Olivia's wave

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Golang (160,486
Github (43,878
Machine Learning (37,716
Deep Learning (36,991
Artificial Intelligence (19,035
Neural (16,689
Neural Network (15,623
Natural Language Processing (14,947
Translation (13,583
Finance (7,028
Chatbot (6,472
Voice Assistant (496
Olivia (5