Skip to content

Orchestrate high-fidelity Voice Conversational Agents with deterministic logic, sub-second latency, and native multi-language support.

License

Notifications You must be signed in to change notification settings

abdofallah/IqraAI

In the name of Allah, the Most Gracious, the Most Merciful.
To Whom belongs all thanks.

Iqra AI Banner

"And God said: Read!"

English   •   العربية   •   中文   •   Русский

Iqra Cloud   •   Documentation   •   Self Hosting   •   Badal Technologies

License Discord LinkedIn LinkedIn Activity

Warning

Pre-Release Notice (v0.1 Pending)
This codebase is currently active but requires manual service configuration. The automated seeding scripts for the database are pending the official v0.1 release. Developers are welcome to explore the architecture, but production deployment requires manual DB setup for now.

The Dynamic AI-First Engine

Iqra AI is an orchestration infrastructure designed to bridge the gap between the chaos of LLMs and the reliability of business code. It allows you to build superhuman Voice & Conversational Agents that think dynamically but act systematically.

Unlike standard "wrappers," Iqra AI provides a Deterministic Logic Layer alongside the probabilistic nature of AI. We prioritize architecture over magic—giving you deep control over latency via multi-region routing, native multi-language support for cultural accuracy, and strict compliance tools for enterprise deployment.

Deployment Options

1. Iqra Cloud (SaaS)

The fully managed, production-ready platform. Includes the multi-tenant Billing System, Whitelabeling Management, and managed infrastructure scaling. Start Building

2. Self-Hosted (Open Source)

Run the core engine on your own infrastructure. This version includes the full Agent Engine, Script Builder, and FlowApp system, but excludes the commercial Billing and Whitelabeling modules. Requirements: .NET 10 Runtime, MongoDB, Redis, Milvus, RustFS (S3). Read the Deployment Guide

3. Enterprise

For large-scale organizations requiring dedicated infrastructure, custom SLAs, on-premise installation support, or specific compliance requirements (e.g., data residency within specific GCC nations). Contact Sales


The Engine

Iqra AI is built on a "Bring Your Own Everything" architecture designed for technical scalability.

Visual IDE

A No-Code graph-based editor that doesn't sacrifice depth. While accessible to non-engineers, it exposes granular control over system prompts, variable states, and tool definitions. It allows you to orchestrate logic, configure intelligence, and debug conversations in a unified studio without context switching.

Embed strict, step-by-step Workflows directly into the conversation. Similar to a visual automation engine running inside your agent, this layer handles conditional routing (If/Else), loops, and math operations deterministically. The AI handles the conversation; the System handles the execution logic.

Translation layers create double latency and lose cultural nuance. Iqra AI runs parallel logic stacks. An agent can switch from an English "Professional" persona (using Deepgram) to an Arabic "Hospitable" persona (using Azure Speech) instantly, mid-sentence, loading a completely different neural configuration.

4. Global Edge Network (Multi-Region)

Designed for horizontal scaling. You can deploy distinct instances of the Iqra Proxy and Backend in geographically disparate clusters (e.g., Kubernetes nodes in US-East vs. EU-Central). The system routes sessions to the nearest compute node to minimize RTP latency and combat physics.

A modular Bring Your Own Model (BYOM) architecture. We provide native, optimized adapters for industry leaders (OpenAI, Azure, Gemini, Anthropic, Groq, ElevenLabs, Deepgram), but the abstract interface allows you to plug in custom fine-tuned models or local inference endpoints easily.

Maintains control of the private context. Our Secure Sessions feature creates a "Clean Room" for sensitive data collection. The audio/DTMF is processed by the deterministic engine via strict Get/Set variable rules. The AI never sees the raw digits, only the validation result, ensuring compliance with data privacy standards.

7. Omnichannel Deployment

One brain, many bodies. Deploy agents via standard SIP Trunking (Twilio, Telnyx, Vonage) or bypass the PSTN entirely using our high-performance WebRTC/WebSocket gateway for browser and mobile app integration with sub-second latency.

An open Plugin System that abstracts external APIs. Developers can write C#/.NET connectors once, define a schema, and let end-users configure credentials and parameters visually (e.g. Cal.com, HubSpot), eliminating the need for repetitive custom HTTP tool scripting.

Give the user full control over the interruption pipeline. The engine allows you to select between standard VAD (Voice Activity Detection), ML-based projection models, or LLM-based decision making to accurately distinguish between a pause, a backchannel ('uh-huh'), and a true barge-in.

10. Whitelabeling (Cloud Only)

A comprehensive system for Agencies to resell the platform. Rebrand the entire dashboard with your logo, custom domain, and define your own pricing structure for your clients.


Contributing

We welcome contributions to the core engine, the Integrations & the FlowApp ecosystem. Please read our Contribution Guidelines before submitting a Pull Request.

Security

We take the security of our platform and our users seriously. If you discover a vulnerability, please do not report it via GitHub Issues. Please read our Security Policy for full disclosure guidelines. Email us directly at: security@iqra.bot

License & Terms

Iqra AI is licensed under a custom Source-Available License.

  • Permitted: Personal use, internal business use, and agency use (managing clients manually).
  • Prohibited: You may not use this codebase to create a competing public SaaS platform.
  • Ethical Clause: Strict usage restrictions apply regarding political and ethical alignment.

Please review the full LICENSE before using or distributing this software.

Acknowledgments

Special thanks to the open-source projects that inspired our architecture and design choices:

About

Orchestrate high-fidelity Voice Conversational Agents with deterministic logic, sub-second latency, and native multi-language support.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published