📖 AllyLens OS — Documentation

What is AllyLens OS?

AllyLens OS is an AI behavioral intelligence platform built around one idea: awareness is not the gap — words are. Most people who want to be allies stay silent in the moment because they don't know what to say. AllyLens detects inequality in real time and gives you the exact words to act.

Getting started

1. Enter your name on the welcome screen.
2. Explore the 19 Lenses from the dashboard — each analyzes a different dimension of group dynamics.
3. Try VoiceLens to record or simulate a meeting, or AllyCoach to get scripts for a situation you're facing.
4. Tap Demo Mode (top bar) for a full guided tour.

The Lenses

Each lens is a specialist. MeetingLens tracks interruptions and speaking balance. VoiceLens transcribes and analyzes live audio. CreditLens catches idea-attribution mismatches. TaskLens surfaces invisible labor. BiasLens, LeadershipLens, InclusionLens and more cover the rest. Open any lens card to see what it does.

AllyCoach & SafeCoach

AllyCoach gives direct, situation-specific scripts — no generic advice. SafeCoach is a confidential space that knows your rights under the German AGG, §201 StGB, and how to reach a Gleichstellungsbeauftragte. Conversations stay on your device.

Meeting Summary Tool

Turn on Meeting Minutes in VoiceLens before recording. Every session is transcribed and summarized — decisions, action items, and who raised what — and the minutes appear on your home dashboard. No note-taking required.

AllyHelp Beta

Personal-safety tools for when you feel unsafe. One-tap emergency calling, a Stay-With-Me check-in timer, live location sharing with contacts you choose, verified helplines, and a realistic fake call (with optional conversational AI voice). AllyHelp routes to trained responders and people you trust — never anonymous strangers.

OfficeHelp Beta

For on-site emergencies at THWS — fire, medical, or a threat. One-tap dialing to 112 and 110 (in Germany, AML automatically shares your GPS with the dispatch centre when you call), a what-to-say script, the official silent-call app nora, and verified Würzburg helplines. OfficeHelp is the primary safety layer; AllyHelp extends it beyond the office.

Privacy

AllyLens runs 100% in your browser. No backend, no database, no tracking. Your sessions, contacts, and journal stay in local storage on your device. Voice recording always requires explicit consent.

Tech

A single self-contained HTML file. Vanilla JavaScript, no framework. AI powered by Google Gemini 2.5 Flash; voice transcription by AssemblyAI. Bilingual (English / German) and theme-aware (light / dark).

AllyLens OS — built for the Science Equality Award 2026 (THWS × ICS).
Made by Amaan Nizam.

🔍

Welcome to AllyLens OS

The AI Behavioral Intelligence Platform for human collaboration, equality, and group dynamics. Who's using this today?

🔍

What is AllyLens OS?

AllyLens OS is an AI Behavioral Intelligence Platform — not a note-taker, not a DEI app. It's an operating system for understanding human collaboration, detecting invisible inequality, and giving you the exact words to act as an ally.

📊19 Behavioral Lenses — each a specialist
🤖Gemini AI Coach — real-time guidance
🎙Voice Mode — transcribe & analyze meetings
Interrupt alerts — exact scripts to act
📈Session history — track change over time
🌐English & German — full translation

Start with MeetingLens to log your first session. Hit ⚡ Demo Mode in the sidebar to see what a fully populated workspace looks like. Your data stays in your browser — private and yours.

🔐

Enable permissions

AllyLens works best with a few permissions. You can skip any and grant them later — nothing is sent anywhere, everything stays on your device.

🎙
Microphone
For VoiceLens — record & transcribe meetings
📍
Location
For AllyHelp — share your location in an emergency
📁
File saving
Save & export session reports and minutes as PDF
🪟
Pop-ups
Lets the emergency button open your dialer & messages
Demo Mode — Viewing sample data. All lenses populated with realistic sessions.
LIVE SIMULATION · Behavioral Intelligence Engine Active
Sessions 0
Events 0
Score

🔔 Notifications

🔍 Ctrl+K
AN
User

Good day! 👋

Welcome to AllyLens OS — Your Behavioral Intelligence Workspace

📝
Last Meeting Minutes
No transcribed meetings yet. Enable Meeting Minutes in VoiceLens to capture summaries here.
Today's Ally Score
Log your first session
All Lenses
Explore behavioral intelligence through specialized lenses
Recent Meetings
🤖
AllyCoach AI
Your AI behavioral coach
Get real-time tips and post-meeting feedback to improve your ally behavior.
Daily Insight
"This tool would be extremely helpful in guiding anyone interested in fostering a fair and inclusive workplace." — Prof. Hilda Körner, THWS
— Prof. Hilda Körner · THWS · First Faculty Review
❤️ 1.2k found this helpful
· Made by Amaan Nizam · AllyLens OS · Science Equality Award 2026
📊
MeetingLens
BETA
Analyze meetings in real-time. Track participation, interruptions, silence & speaking equity.

📋 Session Setup

Session Name
Context
Women in Meeting
2
Men in Meeting
4
Patterns Observed
Idea credit mismatchHer idea credited to someone else
Invisible laborAdmin tasks to women only
Speaking dominance1–2 men dominated 60%+
Dismissive responseHer point was brushed off
Leadership assumptionLead roles defaulted to men
Exclusionary humorSexist joke unchallenged
Women Interrupted
0
Duration (min)
🎙
VoiceLens
Record your meeting audio — AssemblyAI transcribes with speaker diarization, Gemini detects patterns.

🎙 Voice Session Setup

Session Name
Context
Women in Meeting
2
Men in Meeting
4
⚠️ Voice Detection Disclaimer: AI voice gender detection is experimental and may be inaccurate. Participant counts you enter are used as ground truth.
🔒 By recording you confirm all participants have consented. Recording without consent may violate §201 StGB (Germany) and GDPR.
📝 Capture Meeting Minutes
Transcribe the meeting and generate a written summary. Shown on your home dashboard.
🤖
AllyCoach
AI
Your personal AI behavioral coach. Real-time guidance, post-session coaching, and growth plans powered by Gemini 2.5 Flash.
🤖
AllyCoach — Full Session
Powered by Gemini 2.5 Flash · Behavioral intelligence partner
🆘
AllyHelp
Beta
Personal safety tools for when you feel unsafe. Reach trained help fast, share your location with people you trust, and never feel alone on the way home.
In immediate danger?
Emergency services are the fastest way to get trained help.
📞 Call 112 — Emergency
📍 Tap "Show my location" to read your position aloud to the operator
🚶
Stay With Me
Set a timer for your journey. If you don't check in, your trusted contacts are alerted with your last location.
📲
Call someone you trust
Feeling uneasy on an empty street? Start a call with a trusted contact and share your live location with them.
👥
Trusted Contacts
People you choose — friends, family, anyone. Only they receive your location. Never strangers.
📞
Fake Call
Need an excuse to leave? Trigger a realistic incoming call to step away from an uncomfortable situation.
🤖 Conversational AI voice
When on, you can actually talk and the caller replies in real time (needs Chrome + internet + mic). When off, a reassuring scripted voice plays.
📚
Verified Resources
Trained, confidential support lines.
incoming call
Mom
mobile
Mom
00:00
A voice is speaking. Hold the phone to your ear and walk to safety. Tap End call when safe.
🏢 OfficeHelp Beta
Fast routing for on-site emergencies at THWS Würzburg — fire, medical, security, or feeling unsafe. The primary AllyLens safety layer; AllyHelp covers beyond the office.
📍 In Germany, calling 112 (and 110 in Bavaria) automatically shares your precise GPS location with the dispatch centre via AML — no setup needed. Tap below to also see your coordinates to read aloud.
What to tell the operator
1 Where — building, floor, room (e.g. "THWS, Sanderheinrichsleitenweg 20, building 7, room 2.14")
2 What happened — fire, injury, threat
3 Who is affected — how many people, are they conscious
4 Wait — do not hang up until the operator does
Can't speak safely?
📲
Use nora — the official German emergency app
Silently sends an emergency call with your location to the responsible police/fire control centre, no voice needed. Built by the German federal states.
About nora →
🛡
SafeCoach
Confidential
A private, confidential space. If you or someone you know feels unsafe, excluded, or harassed — describe the situation. SafeCoach will help you understand your options, your rights, and your next steps. No data is stored or shared.
🔒 Fully private. SafeCoach runs entirely in your browser. Nothing you share here is stored, logged, or sent anywhere. This conversation ends when you close the tab.
⚠️ Not legal advice. SafeCoach provides general guidance and support, not formal legal counsel. For serious situations, it will direct you to appropriate resources.
🛡
SafeCoach — Confidential Support
Powered by Gemini · Private · No data stored
📋
Pre-Meeting Brief
Enter who is attending. Get a personalised AI briefing based on your session history before you walk in.

Who is in this meeting?

Meeting Name
Context
Attendees (names, comma separated)
Women attending
2
Men attending
3
📊
Session Compare
Pick two sessions and compare side by side. See whether things are improving over time.

Pick two sessions to compare

Session A (older)
Session B (newer)
Ally Action Log
Every time you act as an ally, tap "I Acted" — bottom left of the screen. Your actions build a personal history separate from sessions.
📊
Insights
Cross-lens analytics and behavioral patterns across all sessions.
Ally Score Trend
📈
My Progress
Track your behavioral growth, ally milestones, and collaboration health over time.
Allyship Milestones
🕐
Recent Sessions
All your analyzed meetings and sessions.
⚙️
Settings
Manage your account, preferences, privacy, and AI keys.

👤 Account

Your Name
Language
Interface language
Appearance
Light or dark theme

🔔 Notifications

Live Meeting Alerts
Real-time interruption alerts during sessions
Session Summaries
Post-meeting reports and AI analysis
Weekly Progress
Ally score and behavioral trend updates

🔒 Privacy

Data Storage
All data stored locally in your browser
✓ Local only
AI Processing
Gemini 2.5 Flash — no data retained
✓ GDPR safe
Delete All Data
Remove all sessions and history permanently

🤖 AI API Keys

Groq API Key (primary)
Powers AllyCoach, SafeCoach, summaries & analysis
Gemini API Key (fallback)
Live voice coach only
AssemblyAI Key
Voice Mode transcription
👤
My Profile
Your behavioral intelligence journey and ally progress.
AN
User
AllyLens OS Member
78
Ally Score
12🔥
Day Streak
0
Sessions
👥
Workspace
Collaborative behavioral intelligence for your team.
🎙
AllyCoach Voice
BETA
Speak to AllyCoach. Describe what's happening in your meeting — it whispers back the exact script to use. Powered by Gemini Live API.
Press the button and describe what's happening in your meeting
Tap to start · Tap again to stop
AllyCoach is ready. Describe your situation and get an exact script back.
Powered by Gemini 3.1 Flash Live · Gemini API Key required
🔒 Audio is streamed directly to Gemini — not stored, not recorded. Session ends when you stop.
📖
ReflectionLens
Your personal behavioral journal. What did you notice today? AI detects patterns across entries over time.

📝 New Entry

What did you notice today?
Conflict Prediction
Based on your last sessions, this predicts interruption risk and dominant behavior before your next meeting.
QuickLens
Log a session in 3 taps. 8 seconds. No forms. For when you need to capture something fast.
Ally Action Log
Every time you act as an ally, log it. One tap. The streak that matters.
📋
Pre-Meeting Brief
Before you join a meeting. Enter who will be there and get a personalised behavioural briefing based on your session history.

Who is in this meeting?

Group / Team Name
Women attending
2
Men attending
4
🔍
Lens
Behavioral intelligence lens.
🤖
Lens Coach
Powered by Gemini 2.5 Flash
📊
Weekly Ally Digest
Week of May 12 – 18
🚨

Report an Issue

Something going wrong in your meetings that shouldn't be? Report it anonymously. This goes directly to the AllyLens team — not from your email, completely anonymous.

➕ New Workspace

Create a workspace to group related sessions together.

Workspace Name
Icon
Behavioral Event Detected
Live Meeting Feed
0:00
SocialGraph · Live
0
Interruptions
50%
Speaking Balance
72
Ally Score
🤖
AllyCoach AI
Behavioral Intelligence Coach · Post-Session Analysis
🎙
VoiceLens · Live Session
Product Strategy Sync · 4 speakers · Recording
0:00
📝 Live Transcript Meeting Minutes: ON
Listening...
⚡ Lens Events
📊 Session Report
All 6 core lenses analyzed
🛡
SafeCoach Confidential
Private Support Coach · Nothing stored · Nothing shared
🔍
AI Behavioral Intelligence for human collaboration, equality, and group dynamics
19 Behavioral Lenses
Gemini AI Coach
Real-Time Alerts
Voice Analysis
GDPR Safe
19+
Behavioral Lenses
100%
Browser-based
0s
Data Stored
Science Equality Award 2026 · THWS × ICS
← → Use arrow keys to read the pitch
How It Works · Live
From observation
to intervention
in 4 seconds.
MEETINGLENS DETECTS
Log who attended, set interruption count, tick patterns observed. MeetingLens generates a behavioral dashboard with scores, alerts, and trend data.
ALLYCOACH DELIVERS
Exact scripts for the exact situation. Not "consider speaking up more." Specifically: what to say, when, and why it works — in under 10 words.
VoiceLens records + auto-analyzes
Pre-Meeting Brief from history
Conflict prediction before you walk in
Session Compare over time
Built into the workflow
Detection is just the start
🔒
Anonymous Reporting
Report an incident without revealing your identity — routed confidentially, with the behavioral data attached as evidence.
📝
Meeting Minutes
Every recorded session auto-transcribed and summarized — decisions, action items, who raised what. Zero note-taking.
📤
Export & Share
Reports and minutes export as PDF in one tap — for your team, your supervisor, or the Gleichstellungsbeauftragte.
BEYOND THE MEETING
Safety and memory, built in
📝
Meeting Summary Tool
Every recorded session is auto-transcribed and summarized — decisions, action items, who raised what. Minutes land on the dashboard with zero note-taking.
🏢
OfficeHelp Primary
On-site emergencies at THWS — fire, medical, threat, or feeling unsafe. One-tap 112/110, with Germany's AML auto-sharing your location to dispatch. Plus verified Würzburg helplines and the official nora app for when you can't speak.
🆘
AllyHelp Add-on
Safety beyond the office. Walking home alone: a check-in timer, live location to trusted contacts, and a realistic fake call to exit a bad situation. We deliberately rejected stranger-dispatch on safety grounds.
Technical Architecture
Deployable anywhere.
No backend. No database. No server.
🌐
Single HTML File
The entire platform — 19 lenses, 2 AI coaches, pitch deck, demo mode, PDF export — runs in one HTML file. Deployable from a USB stick.
🔒
100% Client-Side
All data in localStorage. Nothing leaves the browser. GDPR compliant by design. Recording requires explicit consent per §201 StGB (Germany).
🤖
Gemini 2.5 Flash
Live API calls for AllyCoach, SafeCoach, lens analysis, Pre-Meeting Brief, and Gemini Live for real-time voice coaching.
AssemblyAI Universal-2 for speaker diarization · Web3Forms for anonymous reporting · QR-coded PDF exports · EN/DE bilingual interface
Validated by Faculty
What THWS experts said
We shared AllyLens with faculty across equality, social science, and software engineering. Every review was unprompted.
"This tool would be extremely helpful in guiding anyone interested in fostering a fair and inclusive workplace. It immediately alerts the chair to potential problems — primarily during meetings with its voice-activation mode."
— Prof. Hilda Körner
THWS
"Highly innovative and impactful. VoiceLens and AllyCoach have great potential to raise awareness of equality, make unfairness visible, and support people in standing up against discrimination. I am convinced AllyLens can contribute to real behavioral change."
— Anca Aicha
Service Learning, THWS
"Fostering an inclusive workplace starts with making people feel seen, heard, and supported. AllyLens presents a promising approach to promoting gender equality by offering tools to identify patterns of bias and discrimination measurably and objectively."
— Prof. Dalia Mahdy
Software Engineering, THWS
Our Answer to the Brief
Male allyship is not
a mindset.
It is a habit.
Habits are built through repeated specific actions — not through awareness. AllyLens gives men a structured observation practice, an action log, a streak counter, and a coach that speaks to them like an adult. It does not tell them they are bad. It gives them the next move.
"Actually — let her finish. I want to hear where she was going."
That is the whole product. One sentence. Said once. In the right moment. AllyLens makes sure you have it ready.
🏳️‍🌈 Inclusion for everyone
The same engine includes everyone
Equality is not only about women. The behavior AllyLens detects — being talked over, ignored, dismissed — happens to LGBTQ+ colleagues too. Our InclusionLens extends the same detection to misgendering, deadnaming, and assumptions about pronouns or partners.
What InclusionLens catches
Misgendering & deadnaming
Pronoun-respect tracking
"Do you have a girlfriend?" assumptions
Who gets ignored or passed over
AllyCoach gives the words
"Sam uses they/them, just so we all do."

"Let's not assume — ask which pronouns people use."
Male allyship is the brief. Inclusion for everyone is the principle. AllyLens serves both with one system.
Team · THWS × ICS · Science Equality Award 2026
AllyLens OS
AI Behavioral Intelligence for human collaboration, equality, and group dynamics
Architect
👨‍💻
Amaan Nizam
Platform Architecture
Scan to try AllyLens
📱 Scan to try it yourself — right now
allylens.netlify.app
19 Lenses
Gemini AI
100% Browser-Based
GDPR Safe
1 / 10
⚡ Quick Log
3 taps. Under 10 seconds. Session saved.
✊ I Acted
What did you do?
🎤 Returned the floor
⭐ Credited someone's idea
📋 Refused the admin task
✋ Called out the behavior
🤝 Invited a silent voice
💬 Reframed the narrative
Alert