🌌 Token Checker: The Identity Echo Interface

Token Checker is an interactive web-based interface built using Streamlit for the MirAI School of Technology Virtual Summer Internship 2026: The "AI Builder" Track.

Designed as a high-fidelity, futuristic sci-fi terminal interface, it allows operator identity authentication, message transmission payload routing, and active token usage estimation.

---

🚀 Features

1. The UI Shell (Task 1)

• Designed with a premium dark glassmorphic theme featuring smooth gradients, custom typography (Outfit and Share Tech Mono), and glowing borders.
• Integrates custom CSS overrides to bypass Streamlit's default BaseWeb styling for a bespoke, branded appearance.

2. Multi-Data Collection & Validation (Task 2 & 4)

• Collects Operator Identity (Name) and Transmission Message Payload (Message).
• Validates fields natively upon execution:
  • Displays a clean red error alert if the Name is missing.
  • Displays a warm amber warning alert if the Message is missing.

3. Personal Success Broadcast (Task 5)

• Automatically routes valid payloads through an f-string template to broadcast a custom transmission confirmation message.

4. Advanced Challenge: Token Cost Estimator

• Integrates key LLM infrastructure metrics:
  • Calculates the total character length of the payload.
  • Estimates token consumption using the industry heuristic of 4 characters per token (characters / 4).
  • Displays estimated context window metrics in a custom styled cyan status card.

---

🛠️ Tech Stack

• Core: Python 3.8+
• Frontend Framework: Streamlit
• Styling: Vanilla CSS (Injected DOM Overrides)
• Fonts: Outfit, Share Tech Mono (Google Fonts)

---

💻 Local Setup & Execution

Follow these steps to run the application on your local machine:

1. Clone the Repository

git clone https://github.com/sahil4love/tokenchecker.git
cd tokenchecker

2. Set Up Virtual Environment & Activate

Create a virtual environment to keep your workspace isolated and clean:

On Linux/macOS:

python3 -m venv .venv
source .venv/bin/activate

On Windows:

python -m venv .venv
.venv\Scripts\activate

3. Install Streamlit

Ensure Streamlit is installed inside your active virtual environment:

pip install streamlit

4. Launch the Server

Run the application using Streamlit:

streamlit run Streamlit/app.py

Once initialized, open http://localhost:8501 in your browser.

---

⚡ Developer & Operator Notes

• Browser Shield Support: Designed with solid text-color fallbacks so the title and components render perfectly even under strict ad-blockers/privacy shields (e.g. Brave Shields).
• Responsive Layout: Customized .block-container rules compress the UI vertically so that it fits onto a single screen height with zero vertical scrolling required.