github: Access to the Github API, v3.

[ bsd3, library, network ] [ Propose Tags ]

The Github API provides programmatic access to the full Github Web site, from Issues to Gists to repos down to the underlying git data like references and trees. This library wraps all of that, exposing a basic but Haskell-friendly set of functions and data structures.

For more of an overview please see the README:

[Skip to Readme]


Note: This package has metadata revisions in the cabal description newer than included in the tarball. To unpack the package including the revisions, use 'cabal get'.

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees


Versions [RSS] 0.1, 0.1.1, 0.1.2, 0.2.0, 0.2.1, 0.3.0, 0.4.0, 0.4.1, 0.5.0, 0.6.0, 0.7.0, 0.7.1, 0.7.2, 0.7.3, 0.7.4, 0.8, 0.9, 0.10.0, 0.11.0, 0.11.1, 0.12, 0.13, 0.13.1, 0.13.2, 0.14.0, 0.14.1, 0.15.0, 0.16.0, 0.17.0, 0.18, 0.19, 0.20, 0.21, 0.22, 0.23, 0.24, 0.25, 0.26, 0.27, 0.28,, 0.29
Dependencies aeson (>=, attoparsec (>=, base (>=4.0 && <5.0), bytestring, case-insensitive (>=, conduit, containers, data-default, failure, hashable, HTTP, http-conduit (>=1.8 && <2.2), http-types, network, old-locale, text, time, unordered-containers (>=0.2 && <0.3), vector [details]
License BSD-3-Clause
Copyright Copyright 2012-2013 Mike Burns, Copyright 2013 John Wiegley
Author Mike Burns, John Wiegley
Revised Revision 1 made by AdamBergmark at 2017-04-09T11:39:24Z
Category Network APIs
Home page
Source repo head: git clone git://
Uploaded by JohnWiegley at 2014-05-02T17:38:02Z
Distributions Debian:0.23, LTSHaskell:0.29, NixOS:0.29, Stackage:0.29
Reverse Dependencies 11 direct, 0 indirect [details]
Downloads 36224 total (138 in the last 30 days)
Rating 2.0 (votes: 5) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Successful builds reported [all 1 reports]

Readme for github-0.8

[back to package description]


The Github API v3 for Haskell.

Some functions are missing; these are functions where the Github API did not work as expected. The full Github API is in beta and constantly improving.


In your project's cabal file:

-- Packages needed in order to build this package.
Build-depends:       github

Or from the command line:

cabal install github

Example Usage

See the samples in the samples/ directory.


For details see the reference documentation on Hackage.

Each module lines up with the hierarchy of documentation from the Github API.

Each function has a sample written for it.

All functions produce an IO (Either Error a), where a is the actual thing you want. You must call the function using IO goodness, then dispatch on the possible error message. Here's an example from the samples:

import Github.Users.Followers
import Data.List (intercalate)
main = do
  possibleUsers <- usersFollowing "mike-burns"
  putStrLn $ either (\error -> "Error: " ++ $ show error)
                    (intercalate "\n" . map githubUserLogin)


Please see for details on how you can help.


Copyright 2011, 2012 Mike Burns.

Available under the BSD 3-clause license.