Skip to content

Add Aql: autonomous AI social media account manager (MVP) - #3

Draft
power0man wants to merge 1 commit into
masterfrom
claude/software-idea-discussion-gv5utk
Draft

power0man wants to merge 1 commit into
masterfrom
claude/software-idea-discussion-gv5utk

Conversation

@power0man

Copy link
Copy Markdown
Owner

ما هذا المشروع

عقل (Aql) — نظام يدير حساب تواصل اجتماعي في نيتش "علم النفس وفهم البشر" ذاتياً: يبتكر المحتوى بالعربية والإنجليزية، ينتج السلايدات والفيديوهات، يرسلها للموافقة على تليقرام، ينشرها على إنستقرام، ثم يحلل الأداء ويحسّن استراتيجيته.

تم الاتفاق على المواصفات عبر جلسة نقاش (النيتش، اللغتان، الموافقة السريعة أولاً، إنستقرام أولاً ثم تيك توك).

محتوى المرحلة الأولى (MVP)

  • brain.py — توليد حزم محتوى ثنائية اللغة عبر Claude API بمخرجات مهيكلة (Pydantic)، مع حلقة تعلم أسبوعية تحلل الإحصائيات وتوجه المحتوى القادم
  • assets.py — رسم سلايدات 9:16 مع معالجة صحيحة للعربية (Raqm أو reshaper/bidi كبديل)، خطوط Noto Naskh Arabic مضمنة (رخصة OFL)، خلفيات fal.ai اختيارية مع بديل محلي متدرج
  • video.py — تركيب Reel عبر FFmpeg (سلايدات + تعليق صوتي ElevenLabs)
  • approval.py — بوت تليقرام: معاينة + أزرار موافق/رفض/إعادة توليد
  • publisher.py — النشر عبر Instagram Graph API الرسمي (رفع Reels بالبروتوكول القابل للاستئناف، ودعم كاروسيل)
  • analytics.py + db.py — سحب المشاهدات/التفاعل وتخزينها في SQLite
  • وضع --dry-run كامل للاختبار دون أي مفاتيح APIs

الاختبار

  • python -m aql generate --dry-run ✅ يولّد سلايدات عربية وإنجليزية سليمة (مرفقة عينات في المحادثة)
  • دورة الحياة كاملة مختبرة: توليد → موافقة → نشر (محاكاة) → إحصائيات → تقرير
  • فحص بنية جميع الملفات (py_compile) ✅

المتبقي قبل التشغيل الفعلي

المالك يوفر المفاتيح في .env (انظر .env.example): Anthropic، ElevenLabs، تليقرام، وInstagram Graph API (حساب Creator/Business).


Generated by Claude Code

Phase 1 pipeline for the psychology-niche Instagram account:
- Claude-powered bilingual (AR/EN) content generation with structured outputs
- Slide renderer with proper Arabic shaping (Raqm/bidi fallback), bundled
  Noto Naskh Arabic fonts (OFL)
- Optional fal.ai backgrounds and ElevenLabs TTS with local fallbacks
- FFmpeg reel assembly, Telegram approval bot (approve/reject/regenerate)
- Instagram Graph API publisher (resumable reel upload, carousel support)
- Analytics collector and weekly AI learning loop over SQLite
- Full dry-run mode tested end-to-end without external APIs

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EwqiCTihB2LV91k7KZ5JoS
@blocksorg

blocksorg Bot commented Aug 19, 2026

Copy link
Copy Markdown

Mention Blocks like a regular teammate with your question or request:

@blocks review this pull request
@blocks make the following changes ...
@blocks create an issue from what was mentioned in the following comment ...
@blocks explain the following code ...
@blocks are there any security or performance concerns?

Run @blocks /help for more information.

Workspace settings | Disable this message

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants