Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


A set of tools and libraries for real-life Scheme. Multiplatform and mobile.

IMPORTANT NOTE: This repository is deprecated and SchemeSpheres discontinued. However, progress is now being made as smaller libraries, using the new r7rs support in Gambit, which render some of the ideas here implemented obsolete.

Some of these new projects are:


The libraries are implemented in R7RS style. Support and installation depends on the Scheme implementation used. Spheres is mainly developed for Gambit, but nothing stops other implementations to use and adapt these libraries.

Installation for Gambit Scheme

Gambit Version Build Status

In order to use these libraries, we need to provide Gambit with R7RS libraries and syntax-rules support. See below for current limitations. The following process will set up Gambit for use with Spheres in Linux, OSX or Windows:

  1. Compile the syntax expander: go to /spheres/gambit and run ./ This file provides improved syntax-rules support for Gambit.
  2. Copy the .gambini file to your HOME directory. This is Gambit's initialization file, and it is configured to load the syntax expander and a minimal R7RS layer.
  3. (optional) Copy the spheres/ directory into your Gambit's installation library directory (i.e. /usr/local/Gambit/lib).
  4. Update all .gambini paths to where your Spheres files are located (either Gambit's library directory, if you copied the files there, or any other path where you choose to leave Spheres' files).

Basic usage

In order to make a library available within the REPL, the extended load form is used:

(load (spheres/core base))

Spheres also brings automated compilation and multiplatform/mobile build scripts. In order to make this functionality available, you need to install Ssrun. Once you do this, you can download the project template if you want to create a project based on Spheres. Additionally, with Ssrun, you can call the compilation tasks within the REPL:

(load (spheres/core base) compile: #t)


Spheres supports syntax-rules and define-macro syntax. While Gambit will natively support R7RS in the future, at the moment we provide asubset of the functionality for practical usage:

  • Macro systems supported: syntax-rules and define-macro (syntax-case is also supported, but not used).
  • Procedures in each library are within their own namespace (imports/exports are handled).
  • Not supported from R7RS: except, only, rename, include-ci, include-library-declarations. Syntax is always in the global namespace (imports/exports and not handled).


Please, write to the project contributors if you are interested. Any help is welcome!


Spheres - A set of tools and libraries for practical Scheme. Multiplatform and Mobile.







No releases published


No packages published