https://github.com/carlostojal/barnaby

Barnaby is a personal assistant API. This makes it offer many possibilities for integration with your projects. It uses APIs such as NewsAPI and DuckDuckGo Instant Answer API. It works using a neural network built with TensorFlow.
https://github.com/carlostojal/barnaby

barnaby duckduckgo flask neural-network news newsapi openweathermap python tensorflow weather

Last synced: 2 months ago
JSON representation

Barnaby is a personal assistant API. This makes it offer many possibilities for integration with your projects. It uses APIs such as NewsAPI and DuckDuckGo Instant Answer API. It works using a neural network built with TensorFlow.

• Host: GitHub
• URL: https://github.com/carlostojal/barnaby
• Owner: carlostojal
• Created: 2020-01-19T11:24:47.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2020-07-24T15:48:11.000Z (almost 5 years ago)
• Last Synced: 2025-01-15T06:16:31.984Z (4 months ago)
• Topics: barnaby, duckduckgo, flask, neural-network, news, newsapi, openweathermap, python, tensorflow, weather
• Language: Python
• Homepage:
• Size: 1.59 MB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Barnaby

Barnaby is a personal assistant API. This makes it offer many possibilities for integration with your projects. It uses APIs such as NewsAPI and DuckDuckGo Instant Answer API. You can test a [Chatbot Demo](https://github.com/carlostojal/BarnabyChatbot).

## How to use

* Run script ```setup.sh``` to install all required dependencies.

* Set your own API keys on the file ```apis.json```. You will need to create some accounts. All APIs used are free. Used APIs are:

    * NewsAPI

    * DuckDuckGo Instant Answer API (No API key or account needed)

    * OpenWeatherMap API

    * IPGeoLocation API

* Run script ```app.py```.

* That's it! Now by default you can use Barnaby on the address ```http://localhost:5000```.

## Endpoints

Endpoint | Description

-------- | -----------

```/```  | Shows this README

```/api_config``` | Shows API configuration.

```/assistant``` | Barnaby endpoint. ```q``` paramether is mandatory (Example: "How is the weather?"). Set ```train``` paramether to true to train the neural network (not needed, unless you make changes to it). A JSON response will be returned.

## Screenshots

* Chatbot Demo

![Chatbot Demo](https://raw.githubusercontent.com/carlostojal/Barnaby/master/img/chatbot-demo.png?token=AIWB3W6OMTOQDQEBMWYWTAC6QJOE2)

* JSON Response

![JSON Response](https://raw.githubusercontent.com/carlostojal/Barnaby/master/img/json.png?token=AIWB3W252JNKNZJPNK65CO26QJOGU)