gretl image
screenshot thumbnail - click to enlarge

GPL v3




Gnu Regression, Econometrics and Time-series Library

gretl text

Is a cross-platform software package for econometric analysis, written in the C programming language. It is free, open-source software. You may redistribute it and/or modify it under the terms of the GNU General Public License (GPL) as published by the Free Software Foundation.

gretl conference 2017

The fifth biennial gretl conference took place in Athens on June 2-3, 2017; details at Previous conferences took place in Berlin (2015), Oklahoma City (2013), Toruń (2011) and Bilbao (2009).


  • Easy intuitive interface (now in French, Italian, Spanish, Polish, German, Basque, Catalan, Galician, Portuguese, Russian, Ukrainian, Turkish, Czech, Traditional Chinese, Albanian, Bulgarian, Greek, Japanese and Romanian as well as English)

  • A wide variety of estimators: least squares, maximum likelihood, GMM; single-equation and system methods

  • Time series methods: ARIMA, a wide variety of univariate GARCH-type models, VARs and VECMs (including structural VARs), unit-root and cointegration tests, Kalman filter, etc.

  • Limited dependent variables: logit, probit, tobit, sample selection, interval regression, models for count and duration data, etc.

  • Panel-data estimators, including instrumental variables, probit and GMM-based dynamic panel models

  • Output models as LaTeX files, in tabular or equation format

  • Integrated powerful scripting language (known as hansl), with a wide range of programming tools and matrix operations

  • GUI controller for fine-tuning Gnuplot graphs

  • An expanding range of contributed function packages, written in hansl

  • Facilities for easy exchange of data and results with GNU R, GNU Octave, Python, Ox and Stata

Data formats

Supported formats include: own XML data files; Comma Separated Values; Excel, Gnumeric and Open Document worksheets; Stata .dta files; SPSS .sav files; Eviews workfiles; JMulTi data files; own format binary databases (allowing mixed data frequencies and series lengths), RATS 4 databases and PC-Give databases. Includes a sample US macro database. See also the gretl data page.


The current source package


Debian GNU/Linux packages, maintained by Dirk Eddelbuettel; see also

Fedora packages, maintained by Johannes Lips

Whether you're compiling from source or installing a pre-compiled binary, you may want/need to check out gretl's dependencies.

Gretl for MS Windows can be found here, and gretl for Mac OS X here.

The time-series analysis programs X-12-ARIMA and TRAMO/SEATS are available in a form suitable for use with gretl on Linux, as follows.

Binary RPM for X-12-ARIMA


Binary "tarball" for X-12-ARIMA


Debian package for X-12-ARIMA




Binary "tarball" for TRAMO/SEATS


Debian package for TRAMO/SEATS



Gretl calls gnuplot to generate graphs. We require gnuplot version 5.0 (released in January 2015) or higher. See The gretl packages for MS Windows and OS X include a gnuplot version that works well with gretl. For guidance on installing current gnuplot on Linux, please look here.


The gretl manual comes in three PDF files, a User's Guide, a Command Reference and a Hansl primer. English versions of these, formatted for U.S. letter-size paper, are included in the gretl source package and binary distributions. Gretl will access other available versions on demand, via the Internet. You can also find the manual files here.

In addition the Gretl Command Reference and Gretl Function Reference are available in HTML format.

Getting help, reporting bugs

If you use gretl you may wish to join the gretl-users mailing list. This is a moderate-volume list where people request and offer help, discuss new features and so on. The list archive is searchable. There's also a gretl-announce list; this is a read-only list which sends out announcements on the occasion of new releases of gretl.

You can submit bug reports and feature requests using the SourceForge Tracker system.

Contributing to gretl

Do you have ideas or code that you'd like to contribute to gretl? If so, we'd be very pleased to hear from you. You should probably join the gretl-devel mailing list (archive here).

The most obvious way of contributing your expertise to gretl development is by writing a function package (using gretl's scripting language, hansl). You can see a listing of current packages here.

If by any chance you're a C coder then contributions to the underlying gretl library would also be welcome. The only non-negotiable requirement on C code that can be contributed to gretl is that you must be willing to have it appear under the GNU General Public License (GPL), that is, you must be comfortable with having the source released.

Git access and browsing

You can find the gretl git repository here. Notes on basic usage of git are available here and full documentation at


First of all, thanks to Ramu Ramanathan, Professor Emeritus of the University of California, San Diego, for open-sourcing his "ESL" econometric code, which was the starting point for the development of gretl. Professor Ramanathan is author of Introductory Econometrics.

Many people have sent in useful bug reports and suggestions for gretl's development. We are particularly indebted to Ignacio Díaz-Emparanza, Tadeusz Kufel, Pawel Kufel, Dirk Eddelbuettel, Sven Schreiber and Andreas Rosenblad. A. Talha Yalta plays a helpful role in scrutinizing and reporting on gretl's numerical accuracy.

Many thanks to Ignacio Díaz-Emparanza, Susan Orbe, Michel Robitaille, Florent Bresson, Cristian Rigamonti, Tadeusz and Pawel Kufel, Markus Hahn, Sven Schreiber, Hélio Guilherme, Henrique Andrade, Alexander Gedranovich, Talha Yalta, Y. N. Yang, Pavla Nikolovova, Jan Hanousek, Artur Bala, Manolis Tzagarakis, Ioannis Venetis, Vitalie Ciubotaru, Mihaela Nicolau, Oleh Komashko and Juan Estévez for their work in translating gretl.

Thanks to William Greene, author of Econometric Analysis, for his permission to include in the gretl package some datasets relating to interesting examples in his text.

Thanks to the good people on the comp.lang.c of old and for expert advice on many issues. Thanks to Richard Stallman of the Free Software Foundation for all his work in developing and promoting free software, and more specifically for agreeing to "adopt" gretl as a GNU program.

Allin Cottrell, Wake Forest University

Riccardo "Jack" Lucchetti, Università Politecnica delle Marche

Last modified: 2018-03-17