A specialized OCR tool for identifying Unicode glyphs and symbols.
Mapping visual geometry to digital character sets.
Symbolize is an intelligent character recognition tool designed to bridge the gap between handwritten or visual symbols and their Unicode equivalents. Unlike standard OCR, it focuses on the structural properties of glyphs, making it ideal for mathematicians, designers, and developers.
The system uses Google Gemini 2.0 Flash for high-accuracy inference, with a built-in local matching engine to handle basic lookups without requiring an active API connection.
| Feature | Technical Implementation |
|---|---|
| Inference Engine | Multi-modal analysis of image data to extract Unicode & HTML entities. |
| Local Fallback | Deterministic symbol matching for environments without internet access. |
| Performance UI | Minimalist True Black (#000000) interface built with Tailwind CSS. |
| Architecture | Type-safe React 19 frontend with Vite for optimized build times. |
| Grid System | Fully responsive layout that adapts to mobile and desktop terminals. |
The following flow defines how Symbolize processes input and handles fail-safes between the cloud API and local processing.
graph LR
A[Input Image] --> B(Image Pre-processor)
B --> C{API Status}
C -->|Online| D[Gemini Vision API]
C -->|Offline| E[Local Heuristic Matcher]
D --> F[Result Aggregator]
E --> F
F --> G[React UI View]
- Frontend: React 19, TypeScript
- Styling: Tailwind CSS (Modern Glassmorphism)
- Tooling: Vite, ESLint
- AI: Google Generative AI SDK
- Node.js (v18+)
- Google AI Studio API Key (Optional)
# Clone the repository
git clone https://github.com/cipher-attack/cipher-symbolize.git
#go to dir
cd cipher-symbolize
# Install and start
npm install
npm run devIntended for research and educational use. All character recognition is performed on the client-side or via authorized API calls.
