universe terminal

• 

  uTerm example 1

• 

  uTerm temperature select page

• 

  uTerm example 2

• 

  uTerm boot sequence (w/ eastereggs)

• 

  uTerm homescreen

• 

  uTerm tree command

About the Project

The inspiration behind the universe terminal, or uTerm, came from a simple but fascinating thought: The entire universe could be categorized into a filesystem. From blackholes and galaxies, to atoms and quarks, everything could be organized into files and folders. We were inspired by this idea and wanted to visualize the massive scope of the universe and naturally, the most poetic way to interact with a filesystem was through a command-line interface. That's where uTerm was born, a terminal-based universe explorer that lets user navigate the entire cosmos, all from our very own interface.

UTerm uses generative AI not to answer questions or write content, but to imagine and construct the vast complexity of the universe in real time. From information on the atmosphere of Venus to creating interstellar wars, we integrate the Google Gemini API to generate unique, context-aware directories and text files based on where the user is exploring in the cosmic universe. Gemini acts as a co-architect that fills folders with scientific data, speculative concepts, and imaginative narratives. Instead of using AI for shortcuts or rote tasks, uTerm demonstrates how generative models can drive curiosity, discovery, and learning through open-ended exploration. In this way, AI becomes not just a tool, but a companion in uncovering the infinite possibilities of the universe

What we Learned

Throughout this project, we learned:

• How to use developer tools and frameworks (especially Git, Next.js, and FastAPI).
• How to fine-tune AI models and develop web-based applications from start to finish.
• How to work as a team, break down an abstract idea into components, and bring a creative vision to life.

How we built it

• On the frontend, we built a sleek, Linux inspired terminal interface using React, Next.Js, and TailwindCSS, complete with a full set of terminal commands and features such as a tree visualizer and tab-autocomplete, all hosted on Vercel.
• In the backend, we developed a layered API with FastAPI and launched it to the web using Uvicorn and Render. We designed security features such as validating a frontend API key, rate limiting using slowapi, CORS middleware to restrict connection to our frontend, and automatic cleanup which deletes inactive universes after 5 minutes. We integrate the Google Gemini API to generate unique content inside each file and directory, ensuring each universe is different. At the heart of uTerm lies a hand-built file system, modeled as a tree-like structure to keep track of 1,000+ parallel universes, each having infinite detail and scope.
• We used Git extensively (and painfully) to collaborate and save our snapshots, learning firsthand how powerful it can be.

Challenges we ran into

• We accidentally overwrote each other's work multiple times with improper Git merges.
• We also forgot to create feature branches, leading to chaotic main pushes.
• We battled unexpected bugs, deployment issues, and a lack of sleep.

But through it all, we kept learning, creating, and pushing forward.

Built With

• fastapi
• gemini
• javascript
• next.js
• python
• tailwindcss