Please note that the project is still in beta phase. Please report any issues you encounter or suggestions you have. We will do our best to address them quickly. Contributions are very welcome!
We are currently working on an improved documentation page.
For a visual introduction to NeuralProphet, view the presentation given at the 40th International Symposium on Forecasting.
There are several example notebooks to help you get started.
Please refer to our documentation page for more resources.
from neuralprophet import NeuralProphet
After importing the package, you can use NeuralProphet in your code:
m = NeuralProphet() metrics = m.fit(df, freq="D") future = m.make_future_dataframe(df, periods=30) forecast = m.predict(future)
You can visualize your results with the inbuilt plotting functions:
fig_forecast = m.plot(forecast) fig_components = m.plot_components(forecast) fig_model = m.plot_parameters()
You can now install neuralprophet directly with pip:
pip install neuralprophet
If you plan to use the package in a Jupyter notebook, we recommended to install the 'live' version:
pip install neuralprophet[live]
This will allow you to enable
plot_live_loss in the
fit function to get a live plot of train (and validation) loss.
If you would like the most up to date version, you can instead install direclty from github:
git clone <copied link from github> cd neural_prophet pip install .
Before starting it's a good idea to first create and activate a new virtual environment:
python3 -m venv <path-to-new-env> source <path-to-new-env>/bin/activate
Now you can install neuralprophet:
git clone <copied link from github> cd neural_prophet pip install -e ".[dev]" neuralprophet_dev_setup git config pull.ff only
-eflag will install neuralprophet in "editable" mode, meaning that instead of copying the files into your virtual environment, a symlink will be created to the files where they are.
neuralprophet_dev_setupcommand runs the dev-setup script which installs appropriate git hooks for Black (pre-commit) and Unittests (pre-push).
We deploy Black, the uncompromising code formatter, so there is no need to worry about style. Beyond that, where reasonable, for example for docstrings, we follow the Google Python Style Guide
As for Git practices, please follow the steps described at Swiss Cheese for how to git-rebase-squash when working on a forked repo.
We have an active Slack community. Come and join the discussion!
For details, please view the Development Timeline.
The next versions of NeuralProphet are expected to cover a set of new exciting features:
The project efford is led by Oskar Triebe (Stanford University), advised by Nikolay Laptev (Facebook, Inc) and Ram Rajagopal (Stanford University) and has been partially funded by Total S.A. The project has been developed in close collaboration with Hansika Hewamalage, who is advised by Christoph Bergmeir (Monash University).
This is the list of NeuralProphet's significant contributors. This does not necessarily list everyone who has contributed code. To see the full list of contributors, see the revision history in source control.
If you are interested in joining the project, please feel free to reach out to me (Oskar) - you can find my email on the AR-Net Paper.