Eris Weather API
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Eris Build Status

Eris is an open source weather API to get the current weather condition across the globe.


Eris is a simple Spring Boot Java API that is developed as a consolidation of the following services:

The technology stack consists of Spring Boot framework only. The free version of the service is also hosted on Heroku. Though the API can be hosted in any platform that supports Spring Boot. Feel free to fork it and create your private API.


All the project dependencies exist in pom.xml file and once your run the project, all dependencies will be downloaded.

How to use

To run and deploy the project on your local or any desired server, first clone the project and the follow the below instruction.

  • Add Open Weather Map API key to that located under resource folder.

  • Compile and run the API using Maven

      $ maven clean install
      $ cd target
      $ java -jar eris-0.1.0-SNAPSHOT.jar

Project & API documentation

To know more about the project structure and API documentation please refer to our Github page documentation at this link.




Eris Weather API is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

Eris Weather API is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.


© 2017 Kasra Madadipouya