README.md

---
title: README
emoji: 📐
colorFrom: indigo
colorTo: indigo
sdk: static
pinned: true
license: cc-by-4.0
thumbnail: >-
  https://cdn-uploads.huggingface.co/production/uploads/628f7a71dd993507cfcbe587/1m4gucm34KFg6MtprGn75.png
short_description: A unified reference architecture for agentic AI systems
---

<p align="center">
  <img 
    src="https://cdn-uploads.huggingface.co/production/uploads/628f7a71dd993507cfcbe587/U6a8h-tFQ1s_fqayvDznl.png" 
    alt="Agentic AI Systems Architecture (AISA)"
    width="360"
  />
</p>

<p align="center">
  <b>A unified reference architecture for agentic AI systems</b><br/>
  <span style="font-size:16px;">
    A reference architecture proposed by <b>Tuwaiq Academy</b>
  </span><br/>
  <span style="font-size:14px;">
    Design · Evaluation · Governance · Deployment
  </span>
</p>


<p align="center">
  <a href="https://zenodo.org/records/18161880"
     style="display:inline-block; padding:10px 18px; background:#e6d2df; color:#ffffff; text-decoration:none; border-radius:8px; font-weight:600; margin-right:8px;">
    📄 Read the Paper
  </a>
  <a href="https://huggingface.co/spaces/AISA-Framework"
     style="display:inline-block; padding:10px 18px; background:#899dd0; color:#ffffff; text-decoration:none; border-radius:8px; font-weight:600;">
    🤗 HuggingFace Space
  </a>
</p>

<hr/>

<h2 align="center">What is AISA?</h2>

<p align="center" style="max-width:760px; margin:auto;">
  AISA is an <b style="color:#899dd0;">implementation-neutral reference architecture</b> for building
  agentic AI systems. It formalizes how <b>reasoning</b>, <b>execution</b>,
  <b>infrastructure</b>, <b>evaluation</b>, and <b>governance</b> interact to produce
  <b style="color:#e6d2df;">reliable, scalable, and auditable agent behavior</b>.
</p>

<hr/>

<h2 align="center">Architecture Overview</h2>

<p align="center" style="max-width:760px; margin:auto;">
  The following diagram presents the high-level structure of AISA, showing how intelligence,
  cognition, tooling, evaluation, deployment, and governance layers interact within an agentic system.
</p>

<p align="center">
  <img
    src="https://cdn-uploads.huggingface.co/production/uploads/628f7a71dd993507cfcbe587/pDWzqiSTrKFnJN7wUj09c.png"
    alt="Agentic AI Systems Architecture Diagram"
    width="900"
  />
</p>

<hr/>

<h2 align="center">Documentation</h2>

<div align="center">
  <table border="0" cellpadding="0" cellspacing="10" style="border:none; margin:auto;">
    <tr>
      <td>
        <a href="https://huggingface.co/spaces/AISA-Framework/README/blob/main/ARCHITECTURE.md"
           style="display:inline-block; padding:10px 14px; background:#899dd0; color:#ffffff; text-decoration:none; border-radius:8px; font-weight:600;">
          📐 Architecture
        </a>
      </td>
      <td>
        <a href="https://huggingface.co/spaces/AISA-Framework/README/blob/main/CONTRACTS.md"
           style="display:inline-block; padding:10px 14px; background:#e6d2df; color:#ffffff; text-decoration:none; border-radius:8px; font-weight:600;">
          📜 Contracts
        </a>
      </td>
      <td>
        <a href="https://huggingface.co/spaces/AISA-Framework/README/blob/main/ROADMAP.md"
           style="display:inline-block; padding:10px 14px; background:#899dd0; color:#ffffff; text-decoration:none; border-radius:8px; font-weight:600;">
          🧭 Roadmap
        </a>
      </td>
      <td>
        <a href="https://doi.org/10.5281/zenodo.18161880"
           style="display:inline-block; padding:10px 14px; background:#e6d2df; color:#ffffff; text-decoration:none; border-radius:8px; font-weight:600;">
          📖 DOI
        </a>
      </td>
    </tr>
  </table>
</div>

<hr/>

<h3 align="center">Citation</h3>

<pre style="text-align:center;">
Nacar, O., Deema, A., & Mohammed, A. (2026). AISA: A Unified Architecture for Agentic AI Systems. Zenodo. https://doi.org/10.5281/zenodo.18161880
</pre>

<p align="center">
  <em>Status: Active development · ACL submission under review · License: CC BY 4.0</em>
</p>