Skip to content
The easiest way to create web applications with Go
Find file
New pull request
Pull request Compare This branch is 3 commits ahead, 59 commits behind hoisie:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


web.go is the simplest way to write web applications in the Go programming language. It's ideal for writing simple, performant backend web services.


web.go should be familiar to people who've developed websites with higher-level web frameworks like sinatra or It is designed to be a lightweight web framework that doesn't impose any scaffolding on the user. Some features include:

  • Routing to url handlers based on regular expressions
  • Secure cookies
  • Support for fastcgi and scgi
  • Web applications are compiled to native code. This means very fast execution and page render speed
  • Serving static files


Make sure you have the a working Go environment. See the install instructions. web.go targets the Go weekly release. Go is a fast-changing language, and it's easier to keep with the weekly branch than to maintain separate branches.

To use web.go with Go's weekly branch:

  1. Run hg update -r weekly. If you're running an outdated version of Go, or the release version, it likely won't compile.
  2. git clone git://
  3. cd web.go && make install

You can also install using goinstall, but if you do this, the import statement in your go programs will be import instead of just import web.


package main

import (

func hello(val string) string { return "hello " + val } 

func main() {
    web.Get("/(.*)", hello)

To run the application, put the code in a file called hello.go and run:

8g hello.go && 8l -o hello hello.8 && ./hello

You can point your browser to http://localhost:9999/world .

Getting parameters

Route handlers may contain a pointer to web.Context as their first parameter. This variable serves many purposes -- it contains information about the request, and it provides methods to control the http connection. For instance, to iterate over the web parameters, either from the URL of a GET request, or the form data of a POST request, you can do the following:

package main

import (

func hello(ctx *web.Context, val string) { 
    for k,v := range ctx.Params {
        println(k, v)

func main() {
    web.Get("/(.*)", hello)

In this example, if you visit http://localhost:9999/?a=1&b=2, you'll see the following printed out in the terminal:

a 1
b 2


For a quickstart guide, check out web.go's home page

There is also a tutorial

If you use web.go, I'd greatly appreciate a quick message about what you're building with it. This will help me get a sense of usage patterns, and helps me focus development efforts on features that people will actually use.


web.go was written by Michael Hoisie.

Follow me on Twitter!

Something went wrong with that request. Please try again.