gi is a Go interpreter that creates an executable representation of a Go program from source. It offers a virtual machine that can step through such a program and allows access to the full stack and scoped variables (environment).

gi is implemented using Go reflection API so one can expect 10x slower program execution depending on the complexity.

• support type parameterization (generics)
• support Go modules (will require pre-compilation)

• offer a DAP interface
• handle source changes during a debugging session:
  • change a function definition
  • change a struct definition
  • add package constant|variable
• debugging concurrent programs

This is work in progress. See examples for runnable examples using the gi cli. See status for the supported Go language features.

go install github.com/emicklei/gi/cmd/gi@latest

gi run .

gi step .

gi dap --listen=127.0.0.1:52950 --log-dest=3 --log

For development, the following environment variables control the execution and output:

• GI_TRACE=1 : produce tracing of the virtual machine that executes the statements and expressions.
• GI_CALL=out.dot : produce a Graphviz DOT file showing the call graph.

package main

import "github.com/emicklei/gi"

func main() {
	pkg, _ := gi.Parse(`package main

import "fmt"

func Hello(name string) int {
	fmt.Println("Hello,", name)
	return 42
}
`)
	answer, err := gi.Call(pkg, "Hello", "3i/Atlas")
}

	gopkg, _ := pkg.LoadPackage(".", nil)
	ipkg, _ := pkg.BuildPackage(gopkg)
	runner := pkg.NewDAPAccess(pkg.NewVM(ipkg))
	runner.Launch("main", nil)
	for {
		if err := runner.Next(); err != nil {
			if err == io.EOF {
				return
			}
		}
		_ = runner.Threads()
		_ = runner.StackFrames(...)
		_ = runner.Scopes(...)
		_ = runner.Variables(...)
	}

The following features are not supported:

• no functions/consts/vars from the following packages:
  • debug
  • go
  • syscall
  • runtime/testdata
• these symbols are not available because of NumericOverflow in reflect.Value:
  • hash/crc64.ECMA
  • hash/crc64.ISO
  • math.MaxUint
  • math.MaxUint64

The build pipeline uses all programs of Go By Example to check whether they are executable with gi.

© 2026. https://ernestmicklei.com . MIT License