Skip to content

About

No description, website, or topics provided.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

GuideGlass AI

Engineering documentation

VOLTRA Engineering Standard · Architecture & technical deep dive · Design decisions · Tests & evidence · Security & privacy · Roadmap · History · Releases

A shared engineering format, with project-specific evidence. No unperformed hardware test, semantic release or CI success is implied.

More awareness. Less uncertainty.

A wearable assistive-technology prototype exploring how a camera, an ultrasonic distance sensor, and spoken feedback can make nearby surroundings easier to understand for people who are blind or have low vision.

The engineering goal is simple: turn useful environmental information into a clear, timely cue—not another screen someone must watch.

The actual GuideGlass application running on Windows

Real application screenshot. A photograph of the assembled glasses is still needed.

Camera prototype

Owner-supplied camera-board prototype with a connected USB cable and cabled antenna

Real hardware photograph supplied by the project owner: a compact camera-equipped board, USB connection, and a cabled Seeed Studio antenna marked "2.4G A-02". The exact board, camera sensor and firmware remain unconfirmed. The glasses mount and ultrasonic sensor are not shown; this photograph is not a live-operation test.

Built around a practical signal path

flowchart LR
    C[Camera: JPEG frames] --> W[Windows Python bridge]
    U[Ultrasonic sensor: intended input] -. hardware verification pending .-> W
    W --> B[iPhone / desktop browser]
    B --> V[Spoken feedback]
Loading
  • Camera transport: a real JPEG reached the bridge during a recorded live check.
  • Distance-aware alerts: software accepts valid readings and can request an Arabic warning; physical distance sensing still needs a successful test.
  • Browser interaction: voice, language, and speed controls, with manual demonstrations separated from sensor events.
  • Inspectable engineering: source code, software tests, and dated evidence instead of unsupported performance claims.

Evidence before claims

The recorded check on 15 October 2026 returned HTTP 200 for the bridge and camera, receiving a 7,359-byte JPEG. The distance endpoint returned HTTP 502: an end-to-end ultrasonic demonstration is not yet verified. The earlier recorded software suite passed 49 tests; those are not physical sensor or navigation tests.

Recorded evidence · Hardware status · Verification boundaries

Run it on Windows

Install Python 3.12, run setup_windows.bat, then start_windows.bat. Open http://localhost:8766/ and configure the device address in the app. Setup downloads dependencies and model/browser assets.

Windows + iPhone guide · Python bridge · Tests

Next milestone

Document the assembled glasses, confirm the sensor and electrical interface, then compare real distance samples with known targets and evaluate audible cues in a controlled setting. Spatial-reconstruction research remains in the source; it is not a claim of LiDAR-grade accuracy.

Research prototype—not a navigation or medical safety device. It must not replace a white cane, guide dog, or trained mobility support. No blind-user study or safe street-navigation capability has been demonstrated.

Created by ali9235 · Repository

About

No description, website, or topics provided.

Resources

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages