Added Go Server (#17)

* Added go server

* Added readme for go server

* Fixed documentation and read me of go files

* Updated readme for go server

* Updated documentation of json.go

* Updated formatting of license in go files

* Added cors middleware handler to go server

* Fixed readme for go server

* Update README.md

Added manual go installation instructions

* Update README.md

Added link for manual Go installation

* Update README.md to skip to manual install for Go

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Update README.md

* Updated documentation of main.go

Author: priankakariat

README.md

@@ -9,16 +9,18 @@
 - [Intro](#intro)
 - [API documentation](#api-documentation)
 - [Installation](#installation)
-  - [Using bash script(Linux/macOS)](#using-bash-scriptlinuxmacos)
+  - [Using bash script for Node.js/Flask on Linux/macOS](#using-bash-script-for-nodejsflask-on-linuxmacos)
   - [Install manually(Linux/macOS/Windows)](#install-manuallylinuxmacoswindows)
     - [nvm(Node Version Manager) installation](#nvmnode-version-manager-installation)
     - [Node.js installation](#nodejs-installation)
     - [Flask installation](#flask-installation)
+    - [Go installation](#go-installation)
 - [Run the app](#run-the-app)
   - [Run React client](#run-react-client)
   - [Run backend server](#run-backend-server)
     - [Configure and run Node.js backend](#configure-and-run-nodejs-backend)
     - [Configure and run Python/Flask backend](#configure-and-run-pythonflask-backend)
+    - [Configure and run Go backend](#configure-and-run-go-backend)
 - [Usage](#usage)
 
 ## Intro
@@ -33,7 +35,7 @@ Streaming mode uses Gemini's streaming capability to achieve faster interactions
 The client for this app is written using [React](https://react.dev/) and served using [Vite](https://github.com/vitejs/vite).
 
 ### Backend
-The app currently has 2 different backend servers that the user can choose from, [Flask](https://flask.palletsprojects.com/en/3.0.x/quickstart/) and [Node.js](https://Node.js.org/en).
+The app currently has 3 different backend servers that the user can choose from, [Flask](https://flask.palletsprojects.com/en/3.0.x/quickstart/), [Node.js](https://Node.js.org/en) or [Go](https://go.dev)
 
 ## API documentation
 ### Endpoints available
@@ -90,8 +92,8 @@ This is the <b>streaming</b> POST method route. Use this to send the chat messag
 ## Installation
 Click [here](#windows) to skip to installation on Windows.
 
-For Linux/macOS a setup bash script is available for easy installation. If you prefer installing manually you can skip to [next section](#install-manuallylinuxmacoswindows).
-### Using bash script(Linux/macOS)
+If your choice of backend is Node.js or Flask, for Linux/macOS a setup bash script is available for easy installation. The bash script does not support installation of Go. If you wish to use Go as your backend or prefer installing manually, you can skip to the [next section](#install-manuallylinuxmacoswindows).
+### Using bash script for Node.js/Flask on Linux/macOS
 #### Make the script executable
 ```
 chmod +x setup.sh
@@ -167,6 +169,14 @@ You can quickly install the required packages using the `package.json` file.
 pip install -r requirements.txt
 ```
 
+#### Go installation
+
+Check if Go is already installed on your system.
+```
+go version
+```
+If Go is not installed, follow the instructions for your operating system from the [official Go installation guide](https://go.dev/doc/install).
+
 ## Run the app
 To launch the app you have to perform the following steps:
 1. Run React client
@@ -238,6 +248,22 @@ python app.py
 ```
 The server will start on `localhost:9000`.
 
+##### Configure and run Go backend
+###### Configuration
+You need a Gemini API key to run the server,
+
+If you don't have a Gemini API key ready, you can create a key with one click in [Google AI Studio](https://aistudio.google.com/app/apikey).
+You must set the API key as an environment variable while running the application.
+
+###### Running the Application
+1. Navigate to the app directory, `server-go` (i.e. where main.go is located).
+2. Run the application with the following command.
+```
+GOOGLE_API_KEY=<your_api_key> go run .
+```
+The server will start on `localhost:9000`.
+By default, the server starts on port 9000. You can override the default port the server listens on by setting the environment variable `PORT` in the command above.
+
 ## Usage
 To start using the app, visit [http://localhost:3000](http://localhost:3000/)
 

server-go/README.md

@@ -0,0 +1,24 @@
+# Gemini chat app with Go
+
+## Install Go
+To run this server, Go must be installed on your system.
+Check if Go is already installed.
+```
+go version
+```
+If Go is not installed, follow the instructions for your operating system from the [official Go installation guide](https://go.dev/doc/install).
+
+## Run the application
+You need a Gemini API key to run the server,
+
+If you don't have a Gemini API key ready, you can create a key with one click in [Google AI Studio](https://aistudio.google.com/app/apikey).
+
+1. Navigate to the app directory, `server-go` (i.e. where main.go is located).
+2. Run the application with the following command.
+```
+GOOGLE_API_KEY=<your_api_key> PORT=<your_port> go run .
+```
+
+## Environment Variables
+* GOOGLE_API_KEY: API key for Gemini service.
+* PORT: The port this server is listening on (default 9000).

server-go/go.mod

@@ -0,0 +1,43 @@
+module chat
+
+go 1.23.0
+
+require (
+	github.com/google/generative-ai-go v0.18.0
+	github.com/rs/cors v1.11.1
+	google.golang.org/api v0.199.0
+)
+
+require (
+	cloud.google.com/go v0.115.1 // indirect
+	cloud.google.com/go/ai v0.8.2 // indirect
+	cloud.google.com/go/auth v0.9.7 // indirect
+	cloud.google.com/go/auth/oauth2adapt v0.2.4 // indirect
+	cloud.google.com/go/compute/metadata v0.5.2 // indirect
+	cloud.google.com/go/longrunning v0.6.1 // indirect
+	github.com/felixge/httpsnoop v1.0.4 // indirect
+	github.com/go-logr/logr v1.4.2 // indirect
+	github.com/go-logr/stdr v1.2.2 // indirect
+	github.com/golang/groupcache v0.0.0-20210331224755-41bb18bfe9da // indirect
+	github.com/google/s2a-go v0.1.8 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/googleapis/enterprise-certificate-proxy v0.3.4 // indirect
+	github.com/googleapis/gax-go/v2 v2.13.0 // indirect
+	go.opencensus.io v0.24.0 // indirect
+	go.opentelemetry.io/contrib/instrumentation/google.golang.org/grpc/otelgrpc v0.55.0 // indirect
+	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.55.0 // indirect
+	go.opentelemetry.io/otel v1.30.0 // indirect
+	go.opentelemetry.io/otel/metric v1.30.0 // indirect
+	go.opentelemetry.io/otel/trace v1.30.0 // indirect
+	golang.org/x/crypto v0.27.0 // indirect
+	golang.org/x/net v0.29.0 // indirect
+	golang.org/x/oauth2 v0.23.0 // indirect
+	golang.org/x/sync v0.8.0 // indirect
+	golang.org/x/sys v0.26.0 // indirect
+	golang.org/x/text v0.19.0 // indirect
+	golang.org/x/time v0.7.0 // indirect
+	google.golang.org/genproto/googleapis/api v0.0.0-20240930140551-af27646dc61f // indirect
+	google.golang.org/genproto/googleapis/rpc v0.0.0-20240930140551-af27646dc61f // indirect
+	google.golang.org/grpc v1.67.1 // indirect
+	google.golang.org/protobuf v1.34.2 // indirect
+)