download.html

---
layout: default
title: GECODE download
headline: Download
---

{% assign GECODESTAMP = site.data.versions["gecodestamp"] %}
{% assign GECODECLEARDATE = site.data.versions["gecodecleardate"] %}

{% capture GECODESOURCETGZ %}release-{{ GECODESTAMP }}.tar.gz{% endcapture %}
{% capture GECODESOURCEZIP %}release-{{ GECODESTAMP }}.zip{% endcapture %}

<p>
  Gecode {{ GECODESTAMP }} has been released on {{ GECODECLEARDATE }}
  (<a href="https://github.com/Gecode/gecode/releases/tag/release-{{ GECODESTAMP }}">Release</a>).
  Gecode is distributed under the MIT license. See our
  <a href="{{ '/license.html' | relative_url }}">license information page</a> for details.
  If you find any bugs, please report them using
  <a href="https://github.com/Gecode/gecode/issues">the Gecode issue page on GitHub</a>.
</p>

<p>
  After unpacking the source archive, configure and build Gecode with CMake:
</p>

<pre>cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build</pre>

<p>
  You can then install it using the standard CMake install step:
</p>

<pre>cmake --install build</pre>

<p>
  Gecode comes with an interpreter for the FlatZinc language
  (see our <a href="{{ '/flatzinc.html' | relative_url }}">FlatZinc page</a> for details).
</p>

<section class="page-section">
  <h2>Source Packages (Version {{ GECODESTAMP }})</h2>
  <p>
    Gecode {{ GECODESTAMP }} is distributed as source code. We do not publish
    pre-built Windows or Mac packages for this release. The source archive is
    generated from the <code>release-{{ GECODESTAMP }}</code> tag.
  </p>
  <ul class="simple-list">
    <li>{% include download-src.html link=GECODESOURCETGZ %}</li>
    <li>{% include download-src.html link=GECODESOURCEZIP %}</li>
  </ul>
</section>

<section class="page-section">
  <h2>Source Code on GitHub</h2>

  <p>
    The Gecode source code is also available via our GitHub repository. The
    released version (currently {{ GECODESTAMP }}) is available as the
    <code>release-{{ GECODESTAMP }}</code> tag:
  </p>

  <p>
    <a href="https://github.com/Gecode/gecode/tree/release-{{ GECODESTAMP }}"><code>https://github.com/Gecode/gecode/tree/release-{{ GECODESTAMP }}</code></a>
  </p>

  <p>
    To get started, check out the current release using the command
  </p>

  <pre>git clone --branch release-{{ GECODESTAMP }} --depth 1 https://github.com/Gecode/gecode.git</pre>

  <p>
    You can also try out the cutting-edge development version of Gecode.
    Please note, however, that this version reflects work in progress,
    so there may be bugs. It even may not compile at all. So, for the
    curious and venturous, try the main branch:
  </p>

  <pre>git clone --branch main https://github.com/Gecode/gecode.git</pre>
</section>

<section class="page-section">
  <h2>Previous Versions</h2>

  <p>
    Previous versions of Gecode can be found on
    <a href="https://github.com/Gecode/gecode/releases/">GitHub</a>.
    Older releases may include binary packages for Windows and Mac.
  </p>
</section>