العربية English Bahasa Melayu
Download
NewShamel Zaki 0.9·Free for everyone

An AI assistant inside Maktabah Shamela

Answers from your library, with book, volume and page.

Download for Mac Windows · coming soon

Apple silicon · macOS 13 or later · Claude or ChatGPT subscription

Interactive demo · real answers, recorded earlier
Shamel Zaki (interactive demo)
Open on a wider screen to try the interactive demo.

Next to the page you’re reading

In a book or search tab, open the side panel and ask about the page in front of you.

Interactive demo · real answers, recorded earlier
Open on a wider screen to try the interactive demo.

Setup

  1. Download and open

    Open the zip, then open Shamela AI. If macOS blocks it, go to System Settings › Privacy & Security and click Open Anyway.

  2. Install

    Quit Shamela, then click Install.

  3. Connect an account

    In Shamela, open Shamel Zaki (الشامل الذكي on the toolbar), click ⚙ at the bottom of the sidebar, then الحسابات (Accounts). Install and sign in to Claude or ChatGPT.

Installing Claude Code or Codex

The easy way is inside the app: ⚙ › Accounts, then Install and Sign in. To do it by hand, open Terminal (⌘ Space, type Terminal) and paste these commands.

Claude Code for a Claude plan

Official installer:

curl -fsSL https://claude.ai/install.sh | bash

Or with Homebrew:

brew install --cask claude-code

Then open a new Terminal window and sign in with your Claude account:

claude auth login

Codex for a ChatGPT plan

With Homebrew:

brew install --cask codex

Or with npm (needs Node.js from nodejs.org):

npm install -g --prefix ~/.npm-global @openai/codex

Then sign in with ChatGPT (after npm, use ~/.npm-global/bin/codex login):

codex login

Reopen Shamela afterwards. The account shows as ready in ⚙ › Accounts.

Questions

Do I need Claude Code or Codex?

Yes, at least one. The assistant runs through them on your own subscription. You can install either from Settings › Accounts.

Which plans work?

Claude Pro, Max or Team, or ChatGPT Plus, Pro or Business. Free plans and API keys don’t work.

Does it cost anything?

No. Usage counts toward your subscription’s limits.

Install in Settings didn’t work

Install it by hand from Terminal: see Installing Claude Code or Codex.

Can it read my files?

No. It reads Shamela’s books and nothing else, and it has no internet access. The only exception is a file you attach yourself.

Where do my questions go?

To Anthropic or OpenAI, through your account. Your chats are saved on your Mac.

macOS says it can’t verify the app

That’s expected: the app isn’t registered with Apple. Click Open Anyway, as in step 1.

What happens when Shamela updates?

It reinstalls itself. Reopen Shamela when the notification appears.

Windows or an Intel Mac?

Not yet.

How do I remove it?

Open Shamela AI again and click Remove. Your chats stay in ~/Library/Application Support/Shamela-AI.