helix-go is a Go library for interacting with helix-db a powerful graph-vector database written in rust. It enables intuitive and type-safe access to graph-based and vector-based queries, making it ideal for building knowledge graphs, search systems, and LLM pipelines.
Installation go get github.com/HelixDB/helix-go Setup To setup a simple Client to interface with a running helix instance:
import " github.com/HelixDB/helix-go " // Create a new HelixDB client var helixClient * helix . Client helixClient = helix . NewClient ( "http://localhost:6969" ) The default URL is http://localhost:6969. For cloud deployments, simply pass in the appropriate URL to the constructor.
Creating structs You can create structs to represent the data returned from queries. This is useful for type safety and ease of use.
type GetUsersResponse struct { Users [] struct { Name string `json:"name"` Age int32 `json:"age"` Email string `json:"email"` CreatedAt interface {} `json:"created_at"` UpdatedAt interface {} `json:"updated_at"` } `json:"users"` } type CreateUserResponse struct { User struct { Name string `json:"name"` Age int32 `json:"age"` Email string `json:"email"` CreatedAt interface {} `json:"created_at"` UpdatedAt interface {} `json:"updated_at"` } `json:"user"` } Running queries You can run queries by passing the query name and data matching the query’s expected inputs.
// Create user data now := time . Now () timestamp := now . Unix () timestamp32 := int32 ( timestamp ) newUser := map [ string ] any { "name" : "John" , "age" : 21 , "email" : "johndoe@email.com" , "now" : timestamp32 , } // Create user in Helix var createdUser CreateUserResponse err := HelixClient . Query ( "create_user" , helix . WithData ( newUser ), ). Scan ( & createdUser ) if err != nil { log . Fatalf ( "Error while creating user: %s " , err ) } fmt . Println ( "Created user:" , createdUser ) // Get all users and put Helix's response in GetUsersResponse var getUsersResponse GetUsersResponse err = HelixClient . Query ( "get_users" ). Scan ( & getUsersResponse ) if err != nil { log . Fatalf ( "Error while getting users: %s " , err ) } fmt . Println ( "Get users response:" , getUsersResponse ) Full Code Example package main import ( " fmt " " log " " time " " github.com/HelixDB/helix-go " ) var HelixClient * helix . Client type GetUsersResponse struct { Users [] struct { Name string `json:"name"` Age int32 `json:"age"` Email string `json:"email"` CreatedAt interface {} `json:"created_at"` UpdatedAt interface {} `json:"updated_at"` } `json:"users"` } type CreateUserResponse struct { User struct { Name string `json:"name"` Age int32 `json:"age"` Email string `json:"email"` CreatedAt interface {} `json:"created_at"` UpdatedAt interface {} `json:"updated_at"` } `json:"user"` } func main () { // Connect to client HelixClient = helix . NewClient ( "http://localhost:6969" ) // Create user data now := time . Now () timestamp := now . Unix () timestamp32 := int32 ( timestamp ) newUser := map [ string ] any { "name" : "John" , "age" : 21 , "email" : "johndoe@email.com" , "now" : timestamp32 , } // Create user in Helix var createdUser CreateUserResponse err := HelixClient . Query ( "create_user" , helix . WithData ( newUser ), ). Scan ( & createdUser ) if err != nil { log . Fatalf ( "Error while creating user: %s " , err ) } fmt . Println ( "Created user:" , createdUser ) // Get all users and put Helix's response in GetUsersResponse var getUsersResponse GetUsersResponse err = HelixClient . Query ( "get_users" ). Scan ( & getUsersResponse ) if err != nil { log . Fatalf ( "Error while getting users: %s " , err ) } fmt . Println ( "Get users response:" , getUsersResponse ) } 
