Skip to content
Java Shell
Branch: develop
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
src Add WASP Dependency-Check Jan 8, 2020
static/logo Add logo to the repository Jan 19, 2020
util Update Oct 31, 2018
.gitignore Fix merging issue Jul 16, 2017
.travis.yml Update .travis.yml Oct 31, 2018
LICENSE Initial commit Jan 29, 2017 Switch to the explicit parameter for Heroku deployment Jan 19, 2020
app.json Update the logo path Jan 19, 2020
pom.xml [maven-release-plugin] prepare for next development iteration Jan 19, 2020 Change to JDK 11 Oct 20, 2018

Eris Build Status SonarCloud

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.

Heroku deployment



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-[version]-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-2019 Kasra Madadipouya

You can’t perform that action at this time.