An interactive CLI application for learning Go programming concepts through hands-on practice. This project provides a structured learning experience with explanations, examples, and coding challenges.

• Interactive Learning: Step through Go concepts with guided explanations
• Hands-on Practice: Solve real coding problems in your editor
• AI-Powered Explanations: Optional AI-generated comprehensive explanations using Google Gemini
• Progressive Difficulty: 16 lessons covering fundamentals to advanced topics
• Immediate Feedback: Built-in testing for your solutions

• Variables and Types
• Slices and Arrays
• Functions and Methods
• Structs and Interfaces
• Pointers and Memory Management
• Packages and Modules
• Control Flow (if/else, loops, switch)
• Data Structures (maps, custom types)
• Error Handling
• Concurrency (goroutines, channels)
• Generics
• Context and Cancellation
• Structured Logging
• JSON Processing
• Testing and Benchmarking

• Go 1.25+ installed and available on your PATH
• Text Editor (VS Code, GoLand, Vim, etc.)

# Clone the repository git clone https://github.com/yourusername/go-learn.git cd go-learn # Run the application go run ./cmd

Enhance your learning experience with AI-powered explanations:

1. Get a Google Gemini API key from Google AI Studio
2. Set the environment variable:

   export GEMINI_API_KEY="your-api-key-here"

3. Restart the application

Features:

• Comprehensive explanations with practical examples
• Real-time content generation
• Automatic fallback to static explanations if AI is unavailable
• Beginner-friendly content tailored for Go learners

1. Choose a Topic: Select from 16 available lessons
2. Learn: Read explanations and study examples
3. Practice: Solve coding challenges in your editor
4. Test: Run automated tests to verify your solutions
5. Repeat: Continue with the next topic

--- 🚀 Go Learning Environment 🚀 --- Choose a topic to learn, or type 'q' to quit: 1. Variables and Types 2. Slices ... > 1 --- Topic: Variables and Types --- 1. Explain 🧠 2. Show Example ✨ 3. Solve Problem 💻 b. Back to main menu > 1 --- AI-Generated Explanation --- [Comprehensive explanation with examples and best practices] 

go-learn/ ├── cmd/ │ └── main.go # CLI entry point ├── internal/ │ ├── lessons/ │ │ ├── lessons.go # Lesson registry and runner │ │ ├── 1_variables_lesson.go │ │ ├── 2_slices_lesson.go │ │ └── ... # Individual lesson files │ └── problems/ │ ├── 1_variables.go │ ├── 2_slices.go │ └── ... # Practice problem files ├── go.mod ├── go.sum ├── README.md ├── CONTRIBUTING.md └── LICENSE 

See CONTRIBUTING.md for detailed instructions on adding new lessons.

# Build only the CLI (recommended) go build -o go-learn ./cmd # Build the entire workspace go build ./...

# Test the entire project go test ./... # Test specific packages go test ./internal/lessons

Go makes it easy to cross-compile for different operating systems and architectures. Here are the commands to build binaries for Windows, Linux, and macOS:

For convenience, we've included build scripts for different platforms:

# Make the script executable and run it chmod +x build.sh ./build.sh

# Run the PowerShell script .\build.ps1 # Or with options .\build.ps1 -Release # Also create release archives .\build.ps1 -Clean # Clean before building

If you prefer using make commands on Windows, you can install GNU Make via winget:

# Install GNU Make winget install ezwinports.make # Restart your terminal/command prompt to refresh PATH # Then use make commands normally: make help # Show available targets make windows # Build Windows binary make linux # Build Linux binary make release # Build all platforms + create archives

After running any build script, you'll find the binaries in the bin/ directory:

bin/ ├── go-learn-windows-amd64.exe # Windows 64-bit ├── go-learn-windows-386.exe # Windows 32-bit ├── go-learn-linux-amd64 # Linux 64-bit ├── go-learn-linux-386 # Linux 32-bit ├── go-learn-linux-arm64 # Linux ARM64 ├── go-learn-darwin-amd64 # macOS Intel └── go-learn-darwin-arm64 # macOS Apple Silicon 

We welcome contributions! Please see our Contributing Guide for details on:

• Adding new lessons
• Improving existing content
• Reporting bugs
• Feature requests
• Code style guidelines

This project is licensed under the MIT License - see the LICENSE file for details.

• Built with ❤️ for the Go community
• Inspired by interactive learning platforms
• Powered by Google Gemini for AI explanations

• Add testing and proper coverage
• Additional Go lessons eventually
• Update Gemini to pull docs link for fully accurate data
• Make problems solvable in the cli
• 🤷 Who knows what else, may not even make it to these items this was a random idea that turned out pretty fun

Happy Learning! 🎉

Found this helpful? ⭐ Star the repo and share with fellow Go developers!