Forem: adi-ray

Building a Stone Paper Scissors Game with Amazon Q CLI: A Step-by-Step Guide

adi-ray — Sat, 31 May 2025 19:10:00 +0000

Overview

This blog walks you through the development of a Stone Paper Scissors game built using Amazon Q CLI, an AI-powered coding assistant that made development faster, smoother, and more enjoyable.

I chose this project because it's a fun and simple way to learn Python, explore clean code architecture, and test the power of Amazon Q CLI in an interactive development environment.

By the end of this blog, you'll learn:

How to install and configure Amazon Q CLI
How to iteratively build a Python game using AI-generated suggestions
How Amazon Q simplifies testing, debugging, and structuring code

Project Setup & Development

Setting Up Amazon Q CLI

Prerequisites

An AWS account
A working Python environment
WSL (for Windows users)

Installation Steps

For Windows Users (WSL Setup):

wsl -d Ubuntu

💡 If you get WSL_E_DISTRO_NOT_FOUND, the below command will install Ubuntu distribution

wsl --install -d Ubuntu

🔗 I referred to this guide for installing Amazon Q CLI on Windows

Start chatting with Amazon Q:

q chat

Planning the Game

I first outlined the core requirements:

Player vs Computer gameplay
Score tracking
Replay option
Clean terminal UI with color support

Then, I structured the project with the following folders:

project-root/
│
├── src/
│   ├── game_engine.py
│   ├── utils.py
│   └── run_game.py
│
├── assets/
│   └── ascii_art.txt

Building with Amazon Q CLI

Initial Prompt

I started by asking:

"Help me create a stone paper scissors game in Python with a clean architecture.
AI Prompt: Stone-Paper-Scissors with Pixel Art & 8-Bit Music

Target Library: PyGame (with Pyganim for pixel animations)

Style: Retro arcade vibe, dynamic AI, and special moves"

Amazon Q provided a basic structure with separate functions for input handling, logic, and scoring.

Iterative Development

I used follow-up prompts like:

"Add colorful terminal output to the game"
"Implement score tracking functionality"

Amazon Q responded with helpful suggestions using libraries like colorama and added features step-by-step, reducing manual effort.

Key Code Components

Some valuable code snippets from Q included:

A score dictionary to track wins
A function for randomized computer moves
A clean game loop with replay options

I refined variable names, added error handling, and tweaked color schemes for better UX.

Testing & Debugging with Amazon Q

Whenever I faced errors (like input mismatches or color issues), I simply asked:

"Fix this ValueError when input is invalid"

"Add unit tests for the game logic"

Amazon Q provided clear fixes and even mocked input() for testable functions.

Deployment

Running the Game

To play the game, simply run:

python src/run_game.py

You'll see:

Colorful prompts
Real-time score updates
ASCII visuals (from assets/)

Screenshots

Click the image above to watch the gameplay demo on YouTube

Lessons Learned

Pros of Using Amazon Q CLI

Super-fast prototyping
Clean, modular code generation
Helpful debugging prompts
Smart suggestions for best practices

Tips for Others

Break down tasks into short prompts
Use follow-ups to refine code
Always test generated code manually

Conclusion

This project demonstrated how Amazon Q CLI can accelerate even small projects like games while encouraging clean architecture and modular design.

If you’re learning Python or want to prototype apps efficiently, give Amazon Q CLI a try!

Resources

🎥 Gameplay Demo Video
🔗 GitHub Repository – Stone Paper Scissors Game
📘 Amazon Q CLI Documentation

🛰How AI Helped Chandrayaan-3 Achieve Its Lunar Mission? 💡🚀 📡

adi-ray — Thu, 24 Aug 2023 14:54:22 +0000

ISRO’s Chandrayaan-3, the third lunar mission has set history by touching down on moon’s surface.

ISRO, or the Indian Space Research Organisation, has pioneered space exploration by launching everything from small satellites to big moon missions. This demonstration of India's technological prowess has helped to establish the country's flag in the international space landscape.

Chandrayaan-3: A Giant Leap to the Moon's South Pole

Chandrayaan-3, the successor to Chandrayaan-2, represents the pinnacle of India's space technology. This lunar mission aims to soft-land a rover near the Moon's south pole. This achievement could catapult India's space industry to unprecedented heights and inspire future generations to reach for the stars. By integrating AI, ISRO joins the global space community in its quest to tap into this technology's potential to unearth cosmic truths.

During the last stage of its landing, the Chandrayaan-3 spacecraft has gone through a window of "17 minutes of terror", where it was carrying out a series of maneuvers which was crucial for landing. It included altitude adjustments, firing thrusters, & scanning the surface for any obstacles - all of that was done with the help of AI. During this period, the Chandrayaan-3 team was able to monitor its progress from the ISRO Telemetry, Tracking, & Command Network in Bengaluru, while Al was at the helm of the Vikram lander. ISRO has already confirmed that the lander used autonomously controlled by Al using Machine Learning that operated its guidance, navigation, control & other systems.

Artificial Intelligence: Guiding the Lunar Rover

At the core of this mission is the pivotal role of Artificial Intelligence (AI). Lander & rover, as well as entire ship is designed & developed using AI, The spacecraft’s design is being optimized for weight, performance, and safety using AI algorithms.
It uses this tech to examine lunar soil, identify obstacles, and send priceless data back to Earth. Built to operate for a lunar day, the rover's AI-driven abilities could broaden our understanding of the lunar surface, atmosphere, and possible water existence.

Artificial Intelligence Reshaping the Space Industry

Given the vast and unpredictable expanse of space, AI's problem-solving and data-analysis abilities can be crucial. AI can help make critical real-time choices, eliminate human errors, and improve overall mission performance.
As we look to the future, the intersection of AI and space exploration promises to push the boundaries of what we thought was possible. AI might become a vital tool for everything from forecasting mission abnormalities to identifying new celestial bodies and potentially organizing interstellar communities.

So, Chandrayaan-3's significance goes beyond its scientific goals. It symbolizes the merging of AI and space exploration, opening a new era where both will jointly fuel our quest to decipher the universe.

     Space technology in the Service of humankind.

Feel free to share this article with your peers and do hit a ❤️ if you liked it. If you have any query, feel free to ask them in the comment section.

You can also connect with me on LinkedIn

Introduction to APIs via Postman

adi-ray — Sun, 12 Mar 2023 13:42:37 +0000

Recently, I had the pleasure of attending an "API 101 with Postman" session. As a newcomer to the world of APIs, I was eager to learn about Postman's capabilities and how it can streamline the API testing and development process. In this blog post, I'll share my experience attending the session and provide a comprehensive overview of Postman API.

About the speaker:
The session was conducted by Divyansh Pratap Singh, who has an extensive experience in API testing and automation.

Agenda of the session:

Intro to APIs and Postman .
Requests and responses.
Hands-on session.
Follow-up resources.

What's an API ?

Software has become more complex and collaborative over the years. Developers no longer need to create every services from scratch.
Application Programming Interfaces(APIs) allow developers to access data from a service (like Google or twitter) without any kowledge of how the codebase has been implemented.

APIs allow services to communicate with each other.

Types of APIs:

Hardware APIs
Software Library APIs
Web APIs

Request-Response Pattern

What is Postman?

Postman is a collaborative API development platform that simplifies creating, using and testing APIs with an interactive UI.

More than 500,000 organizations & 13 million developers use Postman.

One of the main reasons for the increased Popularity of the Postman is because of its interface :

Refer this link for simply creating your postman account.

Making Requests (Interact with the API) :

We were then shown how to send requests to APIs using different HTTP methods, such as GET, POST, PUT, and DELETE.
The 3 ingredients to make a request:

Methods (GET,POST,etc.)
Address / Endpoint (URL)
Path

The response elements for Receiving Requests are :

Status Codes (200 OK , 201 CREATED , 404 NOT FOUND)
Headers
Accessing body data

Resources

Learning Center
API Network
Forum

Attending the Introduction to Postman API session was a great learning experience. We learned about the basics of API with Postman and got hands-on experience with various features of the tool.

Apart from this, we also got to know about the Postman Student Expert Certification which will help us take Postman skills to the next level and showcase our expertise to the world.

Click Here to explore more about Postman Student Programs.

Feel free to share this article with your peers and do hit a ❤️ if you liked my blog. If you have any query about how to get started with Postman , feel free to ask them in the comment section.

You can also connect with me on LinkedIn