# Hedya.dev

> Hedya.dev is an AI engineering platform architected and built by Abdulrahman Hedya for serving domain-specific AI services in your browser or through an API (منصة هندسية لخدمات الذكاء الاصطناعي المتخصصة). The platform operates on a single account, unified credit balance, and declared costs per service, backed by high-throughput distributed infrastructure.

## Platform Offerings & Interactive Tools

- [FRARE Legal Search Engine](https://hedya.dev/tools/frare): Root-aware Arabic search over Egyptian financial regulations and decrees (بحث صرفي باللغة العربية في القرارات والتشريعات الصادرة عن الهيئة العامة للرقابة المالية). Covers 1,100+ official decrees (15,000+ scanned pages) with sub-15ms queries, lemma and standard inflection matching, and regulatory amendment-tree tracking. Public access with no credits currently deducted. Interactive demonstration available at https://hedya.dev/sandboxes/frare.
- [Tadween Speech Pipeline](https://hedya.dev/sandboxes/tadween): In-development speech intelligence prototype (تدوين: تحويل الكلام إلى نصوص، تمييز المتحدثين، وتلخيص المحتوى). Multilingual speech recognition, speaker diarization, and meeting summaries. Interactive sandbox with mocked diarization available at https://hedya.dev/sandboxes/tadween. Open-source specifications on GitHub, pricing to be announced.
- [Platform Services Catalog](https://hedya.dev/services): Complete service catalog (دليل الخدمات والمنتجات) declaring execution parameters, access rules, and transparent cost models before execution.
- [Interactive Sandboxes](https://hedya.dev/sandboxes): Hands-on browser demonstrations and prototype testing playground (بيئة التجربة الحية التفاعلية) for platform engines. Dedicated showcase sandboxes for FRARE (https://hedya.dev/sandboxes/frare) and Tadween (https://hedya.dev/sandboxes/tadween). All sandboxes provide interactive showcases with mocked data.
- [Developer API Suite](https://hedya.dev/dashboard/api-keys): Unified REST gateway (بوابة المطورين وواجهات الربط) with scoped API keys, token-bucket rate limiting, and credit settlement (`POST https://api.hedya.dev/v1/{service_slug}`).

## Developer Portfolio & Architect Profile (/me)

- [Architect Profile](https://hedya.dev/me): Abdulrahman Hedya — AI Software Engineer, Systems Architect, and open-source author/contributor focused on engineering production AI backends, distributed pipelines, speech processing, Arabic NLP, and information retrieval (عن المهندس / الملف الهندسي).
- [Engineering Philosophy](https://hedya.dev/me#profile): "Anyone can execute model inference in a Jupyter notebook. Real software engineering requires taming concurrency, managing memory backpressure, enforcing transactional integrity, and building resilient systems that stay up under continuous load. I built hedya.dev to bridge the gap between AI development and production software engineering — creating a live, observable platform where specialized AI engines run as real software."
- [Career Timeline](https://hedya.dev/me#career): 3-era professional timeline spanning academic research through production platform delivery:
  - **2020 – 2024 (Research & Foundations)**: B.Sc. Computer Science at Minia University; peer-reviewed IEEE research on Arabic acoustic deepfake detection; Eqraa Quran recitation verification assistant; NagibGPT language model trained from scratch.
  - **2024 – 2025 (Freelance AI Engineer)**: Client-facing delivery of AI consulting, MVPs, and PoCs for speech processing and Arabic search; EdTech media analytical pipeline processing 500+ hours of educational recordings.
  - **2025 – Present (AI Software Engineer & Platform Builder)**: Architect and maintainer of hedya.dev production platform; FRARE regulatory engine serving 1,100+ decrees at 6,871 RPS (p99 3.2ms); high-standard Python concurrency libraries (resource-semaphore, camel-lite).
- [Curriculum Vitae / Resume](https://assets.hedya.dev/resume.pdf): Direct PDF resume document.
- [GitHub Profile](https://github.com/AHedya): Open-source repositories and contributions.
- [LinkedIn Profile](https://linkedin.com/in/ahedya): Professional background and systems engineering journey.
- [Direct Email Channel](mailto:abdulrahman@hedya.dev): Primary communication channel (`abdulrahman@hedya.dev`).

## Architecture & Engineering Blueprint

- [System Architecture & Topology](https://hedya.dev/architecture): Hybrid System Topology (Modular-Monolith Gateway with Internal & Serverless Microservices) and Microkernel Core with dynamic plugin discovery (المخطط المعماري للمنصة). Free-threaded Python 3.14 / ASGI primitives with serverless offloading for heavy compute (also accessible at https://hedya.dev/blueprint).
- [Zero-Drift Ledger](https://hedya.dev/architecture#zero-drift-ledger): Two-phase credit settlement (سجل المعاملات المالي دون انحراف: Hold → Capture → Refund) with atomic direct-SQL updates on hot balance records, eliminating partial writes.
- [Post-Commit I/O](https://hedya.dev/architecture#post-commit-io): Database connection pool protection (عزل عمليات الدخل والخرج بعد الاعتماد) dispatching slow I/O and worker tasks strictly after transaction commits.
- [Unit of Work (UoW) Pattern](https://hedya.dev/architecture#unit-of-work-uow): Flow orchestrators strictly own database transactions (نمط وحدة العمل); domain services and CRUD functions never invoke commit.
- [Standard Auth Chain](https://hedya.dev/architecture#standard-auth-chain): Hashed credentials, stateless JWT sessions, and scoped action tokens applied uniformly across all services.
- [Infrastructure Stack](https://hedya.dev/architecture#technology-stack): Traefik v3 (Edge Ingress & TLS), FastAPI (Python 3.14 microkernel), PostgreSQL 18 with PgBouncer, NATS JetStream + TaskIQ, Redis rate limiting, OpenTelemetry, React 19, and Vite.
- [Architecture Patterns](https://hedya.dev/architecture#patterns): Hybrid System Topology, Microkernel Architecture, and Language Provider Microservices.

## Operational Charter & Ethical Commitments

- [Data Safety Charter](https://hedya.dev/architecture#data-safety): Non-custodial operational principles (ميثاق سلامة البيانات). Minimal identity storage, strict 6-hour support retention window before permanent deletion, and zero user data ownership claims.
- [Open Source & Transparency](https://hedya.dev/architecture#open-source): Permissive and copyleft licensing (Apache-2.0, MIT, AGPLv3). Guaranteeing derivative works remain free and open under AGPLv3 with explicit pricing margins.
- [Fair Use Policy](https://hedya.dev/architecture#fair-use): Default refunds on failed operations, unified cross-service abuse definitions, and batch settlement.

## Selected Works

- [hedya.dev Platform](https://hedya.dev/): Live modular platform serving specialized AI tools through a web UI and credit-metered developer APIs with zero-drift billing and distributed tracing.
- [IEEE Deepfake Detection Research](https://ieeexplore.ieee.org/document/10753151): Co-authored peer-reviewed research on real-time acoustic feature extraction and neural acoustic representations for Arabic deepfake speech detection (بحث كشف التزييف الصوتي).
- [Eqraa](https://github.com/AHedya/Eqraa): Advanced Quran recitation assistant and acoustic alignment engine (إقراء: المساعد الصوتي لتلاوة القرآن الكريم).
- [Tadween Speech Intelligence](https://github.com/AHedya/tadween): A vendor-agnostic ASR pipeline ecosystem for high-throughput speech intelligence (تدوين: منظومة معالجة وتحليل الصوت).
- [resource-semaphore (PyPI)](https://pypi.org/project/resource-semaphore/): High-level synchronization and backpressure library for heterogeneous resources with sync/async API parity and Python 3.11–3.14t support.
- [camel-lite (PyPI)](https://pypi.org/project/camel-lite/): Modernized, lightweight, and de-bloated port of CAMeL Tools for Arabic NLP.

## Technical Blog & Notes

- [Blog](https://hedya.dev/blog): Technical deep dives and engineering notes on search architectures, Arabic NLP, and distributed systems (المدونة التقنية).

## Developer Documentation & Machine Schemas

- [OpenAPI Specification](https://hedya.dev/openapi.json): Machine-readable OpenAPI 3.1 schema for all platform endpoints.
- [Swagger UI Documentation](https://hedya.dev/docs): Interactive API testing and parameter explorer.

## Optional

- [About the Architect](https://hedya.dev/me): Engineering bio, career timeline, and systems philosophy (/me).
- [Platform Architecture Blueprint](https://hedya.dev/architecture): Complete systems engineering blueprint and technical contracts (/architecture, aliased at https://hedya.dev/blueprint).
- [Interactive Sandboxes](https://hedya.dev/sandboxes): Live testing sandboxes and prototype demonstrations (/sandboxes, /sandboxes/frare, /sandboxes/tadween).
- [Contact & Consulting](https://hedya.dev/contact): Technical collaboration inquiries and communication channels.
- [GitHub Profile](https://github.com/AHedya): Open source repositories and contributions.
- [LinkedIn Profile](https://linkedin.com/in/ahedya): Professional background and systems engineering journey.
- [Curriculum Vitae / Resume](https://assets.hedya.dev/resume.pdf): Direct PDF resume document.
- [Full Text Markdown (llms-full.txt)](https://hedya.dev/llms-full.txt): Complete, concatenated Markdown export of the entire platform.