Skip to content
Bespin Running on CouchDB
JavaScript Python PHP Java Vim script ActionScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Commits To Push Upstream
* 052340435b01c8900cc024bea953e21faa32b2bc - Fix several relative image resource links
  * Accidentally included whitespace changes in commit - need to remove before pushing upstream
* 54039f26425918538392f4f2e74e6c6257249f26 - Allow override of content-type

Building Bespin Couch
Follow directions from Bespin Developer Guide:

Specifically, bootstrap, bin/activate, and paver dojo create_db. Instead of
running the Bespin development server, we'll be pushing the code to
CouchDB and running from there.

* make sure you've followed Bespin setup guide down to paver dojo create_db step
* cd couchapp
* edit .couchapprc to point to your CouchDB server
* couchapp push bespin apps (may take several minutes for the first push)
* point your browser at

Original Bespin Readme Below

Welcome to Bespin!

Bespin is a Mozilla Labs experiment on how to build an extensible Web code 
editor using HTML 5 technology.

Project home page:
Live system:

Thanks for downloading the code to the Bespin project. You can easily get 
Bespin's Python server running on your local Mac or Linux machine (see note 
about Windows below).

Getting Started

*** NOTE FOR LINUX USERS: If you are running on a Linux system, you will 
likely need a "python-dev" (on Ubuntu, possibly python-devel elsewhere) 
package installed and either the libc-dev or libc6-dev package, if you 
do not already have them.

*** NOTE FOR MAC USERS: If you put your Bespin checkout in a directory
that has a space in the directory name, the bootstrap script will fail
with an error "no such file or directory" because there will be
scripts generated with an invalid shebang (#!) line.


  python --no-site-packages
to get the environment set up. This is built around virtualenv. All of the
required packages will automatically be installed. Once this is set up,
you can run::

  source bin/activate
to enter the virtualenv. Alternatively, you can just prefix the commands you
run with "bin/". If you wish to restore your command line environment,
you can type "deactivate".

The first time around, you'll need to download Dojo and create the database::

  paver dojo create_db

You can start up the development server (runs on localhost:8080) by running::

  paver start

You can run the unit tests by running::

  nosetests backend/python/bespin

Updating the Required Files

If the "requirements.txt" file changes, you can re-install the
required packages by running::

  paver required
You can also force upgrade all of the packages like so::

  pip install -U -r requirements.txt

More Documentation

Documentation for Bespin's code and APIs are actually part of every
instance of the Bespin server. To view the docs on your local instance, just
browse to

Contributing to Bespin

For details see:

The source repository is in Mercurial at:

Note about running on Windows

The current, up-to-date Bespin backend is written in Python. Because
Python is cross-platform, it should be possible (and likely not too
difficult) to make the backend work on Windows once Python 2.5 is
installed. However, this has not been tested and there are likely two

1. some libraries used by Bespin try to compile C code (*)
2. some paths may not be correct on Windows systems

Microsoft offers free command line compilers that work well with
You can’t perform that action at this time.