gorun

GoRun

العربية · English

نظام إدارة محتوى يعمل فيه فريقك ووكلاء الذكاء الاصطناعي معًا، وتبقى القرارات الحساسة بيد البشر.

يجمع GoRun في لوحة تحكم واحدة، عربية وإنجليزية مع دعم كامل لاتجاه RTL، بين سير عمل الفريق، ووكلاء يعملون عبر REST وMCP بصلاحيات محددة، ولوحات عمل (Canvases) تربط المحتوى بالتعليمات والنتائج. وهو نظام مفتوح المصدر تستضيفه بنفسك بترخيص GNU AGPL v3.

الفريق · الوكلاء · اللوحات · البدء السريع · التوثيق

للفريق

• أدوار تناسب طريقة عمل المحررين. أدوار جاهزة هي admin وeditor وauthor وcontributor، ولكل منها صلاحيات صريحة.
• مراجعة قبل النشر. مسودات، وحالة «بانتظار المراجعة»، ونشر مجدول، وسجل نسخ يمكن الاستعادة منه، وسلة محذوفات.
• سجل يوثّق من فعل ماذا. سجل تدقيق لا يُعدَّل بعد كتابته، يشمل المستخدمين والمفاتيح، ومنها كل استدعاء لأدوات MCP.
• محتوى منظّم. مقالات وصفحات وأنواع وحقول مخصصة وتصنيفات وقوائم ووسائط في لوحة تحكم واحدة.

للوكلاء

1. أنشئ مفتاحًا من نوع AI agent من وكلاء الذكاء الاصطناعي ← مفاتيح API بالنطاقات (scopes) التي يحتاجها فقط.
2. وجّه عميل MCP إلى https://your-site.example/mcp (أو شغّل gorun mcp محليًا عبر stdio).
3. راجع الطلبات الحساسة من وكلاء الذكاء الاصطناعي ← الموافقات؛ ويستعلم الوكيل عن النتيجة بالأداة check_approval.

• حدود واضحة من الأساس. لا يتجاوز المفتاح صلاحيات دور صاحبه، ولا يفعل إلا ما تسمح به نطاقاته.
• البشر يوافقون على الخطوات الحساسة. النشر والحذف وتغيير الإعدادات وتعديل المحتوى المنشور تنتظر موافقة بشرية افتراضيًا. لا تستطيع مفاتيح الوكلاء استخدام REST للموافقة على طلباتها، والموافقة الذاتية نطاق مستقل لا يمنحه *.
• REST لبقية التكاملات. تستخدم السكربتات والخدمات مفاتيح REST منفصلة على /api/v1 (موصوفة في /api/v1/openapi.json)، أما مفاتيح الوكلاء فمرفوضة هناك وتبقى على MCP. وتُبلغ الـWebhooks الخدمات الأخرى بالتغييرات.

يمكنك أن تبدأ بهذه التعليمات بعد ربط الوكيل:

Inspect the site's structure, content types, and the tools available to your key.
Explain your proposed changes before writing anything.
Create new content as drafts and preserve existing content and settings.
If a tool requests approval, report its request ID and wait for the decision.

MCP والصلاحيات · واجهة REST · نماذج الوكلاء

اللوحات (Canvases)

اللوحات (لوحة التحكم ← اللوحات) مساحة عمل تشغيلية، وليست أداة لتصميم الصفحات.

• اجمع عملك في مكان واحد. ملاحظات وقوائم مهام وروابط ومراجع لمقالات وصفحات، وودجات للموافقات والمهام الخلفية وطلبات الخدمة.
• شغّل الوكلاء على سياق تختاره أنت. اربط المصادر والتعليمات بمزوّد نصوص مُعَدّ أو بمفتاح وكيل مسمّى، وراجع السياق كما سيُرسَل، ثم شغّل.
• النتائج تصل ملاحظاتٍ جديدة. تُضاف كل نتيجة ملاحظةً خاصة مع بيان مصدرها، ولا تستبدل بطاقاتك ولا تنشر أي محتوى.
• تكرار دوري بعد المراجعة. الجدولة كل ساعة أو يوم أو أسبوع تبدأ معطّلة، وتحتاج تفعيلًا صريحًا، وتعيد التحقق من الصلاحيات في كل تشغيل.
• صلاحيات صريحة للوكلاء. أنت تحدد العناصر التي يستطيع كل وكيل قراءتها أو الإضافة إليها أو التشغيل عليها في كل لوحة.

مساحة اللوحات · عمليات اللوحات · استوديو المحتوى

وأيضًا

الميزات المعتمدة على مزودين خارجيين تحتاج بيانات اعتماد صالحة. حفظ الاتصال أو تحميل قائمة النماذج لا يثبت أن التوليد أو الدفع يعمل.

منشئ المواقع · القوالب · الترحيل · التجارة

البدء السريع

صورة Docker: تُنشر الإصدارات صورةً متعددة المعماريات (linux/amd64 وlinux/arm64) على GHCR بالوسوم 0.1.0 و0.1 وlatest:

docker pull ghcr.io/zadstack/gorun:0.1.0
docker run --rm --entrypoint /app/gorun ghcr.io/zadstack/gorun:0.1.0 version

تعمل الصورة في وضع الإنتاج وتحتاج GORUN_BASE_URL وGORUN_SECRET_KEY ومجلد بيانات دائمًا على /data؛ ملف Compose الجاهز وخطوات Coolify في دليل Docker / Coolify.

الملفات التنفيذية: كل إصدار على GitHub يرفق أرشيفات لنظامي linux وdarwin بمعماريتي amd64 وarm64، وفيها البرنامج ومجلد themes/ والوثائق، مع ملف SHA256SUMS:

curl -fLO https://github.com/zadstack/gorun/releases/download/v0.1.0/gorun-0.1.0-linux-amd64.tar.gz
curl -fLO https://github.com/zadstack/gorun/releases/download/v0.1.0/SHA256SUMS-0.1.0.txt
sha256sum --ignore-missing -c SHA256SUMS-0.1.0.txt
tar xzf gorun-0.1.0-linux-amd64.tar.gz && cd gorun-0.1.0-linux-amd64
GORUN_ENV=dev GORUN_DATA=./data GORUN_BASE_URL=http://127.0.0.1:8080 ./gorun serve

من المصدر: يحتاج البناء من المصدر إلى Go 1.27 وmake (يثبّت المستودع إصدار الأدوات Go 1.27.2).

git clone https://github.com/zadstack/gorun.git
cd gorun
make build

GORUN_ENV=dev \
GORUN_DATA=./data \
GORUN_THEMES=./themes \
GORUN_ADDR=127.0.0.1:8080 \
GORUN_BASE_URL=http://127.0.0.1:8080 \
./bin/gorun serve

افتح http://127.0.0.1:8080/admin/setup لإنشاء المدير الأول، ثم استخدم http://127.0.0.1:8080/admin. شغّل البرنامج من جذر المستودع ليجد مجلد themes/.

في الإنتاج، اضبط مجلد بيانات دائمًا، وHTTPS، وعنوان الموقع العام (GORUN_BASE_URL)، ومفتاح تشفير ثابتًا، وsetup_token لحماية إنشاء المدير الأول، مع GORUN_ENV=prod، وشغّل عملية خادم واحدة لكل مجلد بيانات؛ يفرض النظام ذلك بقفل gorun.lock داخل مجلد البيانات، فترفض نسخة ثانية من gorun serve (أو gorun mcp --jobs) التشغيل برسالة واضحة. تُضبط الإعدادات في gorun.toml أو عبر متغيرات GORUN_*، ولا تحفظ كلمات المرور أو مفاتيح المزودين في المستودع. راجع دليل التثبيت ودليل الإنتاج ودليل Docker / Coolify.

تحت الغطاء

• ملف تنفيذي واحد بلغة Go. لوحة التحكم مضمّنة فيه، وقوالب المواقع تأتي معه في مجلد themes/.
• SQLite. لا حاجة إلى خادم قاعدة بيانات منفصل.
• بلا Node.js أو PHP وقت التشغيل. يُستخدم Node.js فقط لاختبارات المتصفح الاختيارية في e2e/.
• قابل للبناء عليه. cmd/gorun غلاف رفيع حول الحزمة pkg/cli، ويستطيع برنامجك الخاص إضافة وحداته وأوامره عبر cli.Option. راجع البناء فوق النواة.

make build && make test && make lint

التوثيق

حالة المشروع

GoRun في الإصدار v0.1.0 وما زال قيد التطوير النشط؛ استخدم آخر إصدار أو ابنِه من الفرع main. الحدود الحالية:

• عملية خادم واحدة لكل مجلد بيانات SQLite (يفرضها القفل <data>/gorun.lock)، ولا يوجد تعدد مواقع بقاعدة بيانات مشتركة.
• اللوحات خاصة بصاحبها مع صلاحيات صريحة للوكلاء، وليست مساحة عمل مشتركة لعدة مستخدمين.
• يحتفظ منشئ الصفحات بالمسودة الحالية وآخر تخطيط منشور، لا بسجل كامل للتخطيطات.
• لا يوجد محدّث تلقائي للنواة، ولا توليد موقع كامل من تعليمة واحدة.
• استعادة النسخ الاحتياطية يدوية، ويجب التحقق من التوليد الفعلي لدى المزودين ومن المدفوعات الحية في كل نشر.

المساهمة

نرحّب ببلاغات الأخطاء ومشكلات التوثيق وأفكار الميزات عبر Issues، وبطلبات الدمج. وقّع كل commit بـgit commit -s وفق DCO (دون CLA)؛ التفاصيل في CONTRIBUTING.md. أبلغ عن الثغرات الأمنية بشكل خاص كما في SECURITY.md.

الترخيص

GoRun برنامج حر بترخيص GNU Affero General Public License v3.0. إذا شغّلت نسخة معدّلة منه كخدمة عبر الشبكة، فإن ترخيص AGPL يُلزمك بإتاحة الشيفرة المصدرية المقابلة لمستخدميها.

تحتفظ مكونات الطرف الثالث بتراخيصها الخاصة (راجع web/admin/static/vendor/*.LICENSE وweb/admin/static/fonts/zad/OFL.txt وinternal/builder/static/THREE-LICENSE.txt). راجع NOTICE للإسناد.

English

A CMS where your team and AI agents work together, and people keep the final say.

GoRun brings team workflows, agents with scoped access over REST and MCP, and canvases that connect content, instructions and results into one bilingual (English/Arabic, RTL) admin. It is self-hosted, open source, and licensed under the GNU AGPL v3.

Team · Agents · Canvases · Quick start · Docs

Screenshots come from isolated local environments, not customer data or a connected provider.

For your team

• Roles that match how editors work. Seeded admin, editor, author and contributor roles with explicit permissions.
• Review before it goes live. Drafts, pending review, scheduled publishing, revisions with restore, and trash.
• A record of who did what. An append-only audit log covers people and keys, including every MCP tool call.
• Structured content. Posts, pages, custom types and fields, taxonomies, menus and media in one admin.

For your agents

1. Create an AI agent key in AI Agents → API keys with only the scopes it needs.
2. Point your MCP client at https://your-site.example/mcp (or run gorun mcp locally over stdio).
3. Review sensitive requests in AI Agents → Approvals; the agent polls check_approval for the result.

• Bounded by design. A key never does more than its owner's role allows, and only what its scopes list.
• People approve the risky parts. Publishing, deleting, changing settings and editing live content wait for a human by default. Agent keys cannot use REST to approve their own calls, and self-approval is a separate scope that * does not grant.
• REST for your other integrations. Scripts and services use separate REST API keys against /api/v1 (described by /api/v1/openapi.json); agent keys are refused there and stay on MCP. Webhooks notify other services of changes.

Inspect the site's structure, content types, and the tools available to your key.
Explain your proposed changes before writing anything.
Create new content as drafts and preserve existing content and settings.
If a tool requests approval, report its request ID and wait for the decision.

MCP and permissions · REST API · Agent models

Canvases

Canvases (Dashboard → Canvases) are an operational workspace, not a page designer.

• Gather the work. Notes, checklists, links, article and page references, and widgets for approvals, jobs and service requests.
• Run agents on context you choose. Connect sources and a prompt to a configured text provider or a named agent key, review the exact context, then run it.
• Results arrive as new notes. Each result is appended as a private note with provenance; it never overwrites your cards or publishes content.
• Recurring, but reviewed. Hourly, daily or weekly schedules start disabled, need explicit activation, and recheck permissions on every run.
• Explicit agent grants. You decide which nodes an agent can read, append to or run on each canvas.

Canvas workspace · Canvas operations · Content studio

Also included

Provider-dependent features need valid credentials. Saving a connection or loading its model list does not prove that generation or payment works.

Site builder · Themes · Migration · Commerce

Quick start

Container image: releases publish a multi-arch image (linux/amd64, linux/arm64) to GHCR, tagged 0.1.0, 0.1 and latest:

docker pull ghcr.io/zadstack/gorun:0.1.0
docker run --rm --entrypoint /app/gorun ghcr.io/zadstack/gorun:0.1.0 version

The image runs in production mode and needs GORUN_BASE_URL, GORUN_SECRET_KEY and a persistent /data volume; the Compose file and Coolify steps are in the Docker / Coolify guide.

Binaries: every GitHub release attaches linux and darwin archives for amd64 and arm64, containing the binary, themes/ and the docs, plus a SHA256SUMS file:

curl -fLO https://github.com/zadstack/gorun/releases/download/v0.1.0/gorun-0.1.0-linux-amd64.tar.gz
curl -fLO https://github.com/zadstack/gorun/releases/download/v0.1.0/SHA256SUMS-0.1.0.txt
sha256sum --ignore-missing -c SHA256SUMS-0.1.0.txt
tar xzf gorun-0.1.0-linux-amd64.tar.gz && cd gorun-0.1.0-linux-amd64
GORUN_ENV=dev GORUN_DATA=./data GORUN_BASE_URL=http://127.0.0.1:8080 ./gorun serve

From source: building from source requires Go 1.27 and make (the repository pins the Go 1.27.2 toolchain).

git clone https://github.com/zadstack/gorun.git
cd gorun
make build

GORUN_ENV=dev \
GORUN_DATA=./data \
GORUN_THEMES=./themes \
GORUN_ADDR=127.0.0.1:8080 \
GORUN_BASE_URL=http://127.0.0.1:8080 \
./bin/gorun serve

Open http://127.0.0.1:8080/admin/setup to create the first administrator, then use http://127.0.0.1:8080/admin. Run from the repository root so the server finds themes/.

For production, set a persistent data directory, HTTPS, the public base URL, a persistent encryption key and a setup token, and run one server process per data directory; GoRun enforces this with an OS lock on <data>/gorun.lock, and a second gorun serve (or gorun mcp --jobs) on the same directory refuses to start. See the installation guide, production guide and Docker / Coolify guide.

Under the hood

• One Go binary. The admin is embedded; website themes ship alongside in themes/.
• SQLite. No separate database service to run.
• No Node.js or PHP at runtime. Node.js is only used by the optional browser tests in e2e/.
• Built to extend. cmd/gorun is a thin wrapper around pkg/cli; your own binary can add modules and commands with cli.Options. See Building on the core.

make build && make test && make lint

Documentation

Project status

GoRun is an actively developed v0.1.0; use the latest release or build from main. Current boundaries:

• One server process per SQLite data directory (enforced by <data>/gorun.lock); no shared-database multisite.
• Canvases are private to their owner, with explicit agent grants; they are not a shared multiplayer workspace.
• The page builder keeps the current draft and last published layout, not a full layout history.
• No automatic core updater, and no complete site generation from a single prompt.
• Backup restore is manual; real provider generation and live payments must be verified per deployment.

Contributing

Bug reports, documentation problems and feature ideas are welcome as issues, and pull requests are welcome too. Sign off every commit with git commit -s under the Developer Certificate of Origin (no CLA); see CONTRIBUTING.md. Report vulnerabilities privately as described in SECURITY.md.

License

GoRun is free software under the GNU Affero General Public License v3.0. If you run a modified version as a network service, the AGPL requires you to offer its users the corresponding source code.

Third-party components keep their own licenses (see web/admin/static/vendor/*.LICENSE, web/admin/static/fonts/zad/OFL.txt and internal/builder/static/THREE-LICENSE.txt). See NOTICE for attribution.

Copyright © 2026 ZAD STACK / Ahmed Morsy.