דילוג לתוכן
ai-memory
EnglishPortuguês (Brasil)Españolעברית日本語한국어
תפריט

המוצר

פתרונות

אינטגרציות

מפתחים

שפה

מתחיליםGitHub

מפתחים

התקנה מהירה

התקן, הגדר והפעל את הסוכן. בחר התקנה מקומית למחשב אחד או פעל לפי שלבי השרת המשותף לצוות.

רק אניהצוות שליבודקים שזה עובד

רק אני

מתקינים קובץ בינארי אחד, נותנים לו להעלות שרת מקומי אחד, ואז מפעילים את הסוכן. השרת נקשר ל-127.0.0.1:49374, כך ששום דבר מחוץ למחשב הזה לא יכול להגיע אליו. התקנה חדשה שומרת את הטוקן שלה בקובץ שרק הבעלים יכול לקרוא, וה-hooks וה-CLI קוראים אותו משם, כך שלא מקלידים אותו בכלל.

  1. מתקינים את הקובץ הבינארי

    הסקריפט מוריד את הגרסה שמתאימה למערכת ההפעלה ולמעבד שלכם, בודק אותה מול קובץ ה-.sha256 שפורסם ומסרב להתקין בלי התאמה. הוא מקשר את ~/.local/bin/ai-memory ולא צריך root.

    טרמינל
    curl -fsSL https://github.com/akitaonrails/ai-memory/releases/latest/download/install.sh | sh

  2. מגדירים

    setup יוצר את תיקיית הנתונים והטוקן, מפעיל שירות משתמש ומחבר את הסוכנים שבחרתם. השתמשו ב-setup --plan לתצוגה מקדימה ללא שינויים, או ב-setup --web לבחירת סוכנים בדף דפדפן מקומי.

    טרמינל
    ai-memory setup

  3. מפעילים דרכו את הסוכן

    מפעילים מחדש את הסוכנים פעם אחת. הפעלה ישירה של claude ממשיכה לעבוד גם אחר כך.

    טרמינל
    ai-memory run claude

התקנה

הפעלת השרת

127.0.0.1:49374

הרצת הסוכן

hooks / MCP

כל המסלול ליחיד. השרת נשאר על loopback, והסוכן מגיע אליו בשתי דרכים: ה-hooks לוכדים את הסשן, ו-MCP נותן לסוכן לחפש בו.

ai-memory run הוא הדרך להפעיל סוכן. הוא מחבר את ה-harness בהפעלה הראשונה, בוחר את תחום הפרויקט הנכון ומוסיף המשך סשן בין harnesses. סוכן שמופעל ישירות עדיין לוכד דרך ה-hooks שלו, אבל כשעוברים דרך ה-launcher לא שוכחים כלום. איך עובדות הפעלות מנוהלות.

בודקים שזה עובד

שלוש בדיקות, מהרשת ועד הסוכן.

השרת עונה

בהתקנה חדשה עם אימות, הבקשה הזו ללא אישורים אמורה להחזיר HTTP 401 עם “auth required”. זה מוכיח רק שהשרת נגיש. הבדיקה הבאה בודקת גישת CLI מאומתת.

טרמינל
curl -i http://127.0.0.1:49374/mcp

ה-CLI מגיע אליו

ה-CLI הוא לקוח HTTP דק. אם הפקודה מדפיסה סטטוס, גם ה-hooks יכולים להגיע לשרת.

טרמינל
ai-memory status

הסוכן זוכר

בפרויקט ללא מידע רגיש, מבקשים מהסוכן הראשון לשמור החלטה מסוימת בפרויקט. מסיימים את הסשן, מפעילים סוכן נתמך אחר באותה תיקייה, ואז מבקשים את ההחלטה ואת הדף השמור שתומך בה.

"איזו החלטת פרויקט שמרתי, ובאיזה דף זיכרון היא מתועדת?"

אחרי הסוכן הראשון

שלושתם אופציונליים. עושים אותם כשצריך.

מוסיפים סוכן נוסף

מפעילים אותו פעם אחת דרך ai-memory, וזהו, הוא מחובר. מאותו רגע שני הסוכנים חולקים זיכרון פרויקט אחד.

טרמינל
ai-memory run codex

כל הסוכנים הנתמכים והשמות שלהם

אופציונלי: סיכומים טובים יותר עם LLM

לכידה, חיפוש וסיכומים מבוססי כללים פועלים ללא ספק. הוספת ספק מפעילה סיכומים עשירים יותר ושיפור עצמי מתוזמן, שמחיל עריכות מאומתות אוטומטית כברירת מחדל. בשרתים משותפים הגדר [auto_improve] require_approval = true. הגדר את המשתנים הבאים בסביבת השרת והפעל אותו מחדש.

סביבת השרת
AI_MEMORY_LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-...

השוואת ספקים, כולל מנויים ומודלים מקומיים

מבטלים הכול

זה מסיר רק את מה ש-ai-memory התקין. פקודות ההתקנה הן idempotent, וכל אחת כותבת גיבוי עם חותמת זמן ליד כל קובץ שהיא נוגעת בו.

טרמינל
ai-memory uninstall --apply

הצוות שלי

שרת אחד שכל מחשב וכל חבר צוות מגיעים אליו. אין רפליקציה בין שרתים: זיכרון משותף אומר שכולם מתחברים לאותו שרת.

alice

bob

carol

שרת משותף אחד

טוקן

ויקי אחד לצוות

מפתח API לכל אחד

השרת מחזיק את הוויקי. אנשים מקבלים חשבונות, מחשבים מקבלים מפתחות API, וה-root token נשאר אצל מי שמריץ את השרת.

  1. הפעל את השרת מאחורי פרוקסי מקומי

    התקן תחילה את ה־CLI המקורי במארח השרת. הפקודות מפרסמות את Docker רק ב־loopback ומגדירות אישורי root ל־CLI במעטפת הזו. החלף את memory.example.com בדומיין שלך. שמור את טוקן root פרטי; מחשבים ניידים יקבלו מפתחות אישיים בהמשך.

    בשרת
    ROOT_TOKEN=$(ai-memory generate-auth-token)
export AI_MEMORY_SERVER_URL="http://127.0.0.1:49374"
export AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN"
docker run -d --name ai-memory \
    --restart unless-stopped \
    -p 127.0.0.1:49374:49374 \
    -v ai-memory-data:/data \
    -e AI_MEMORY_AUTH_TOKEN="$ROOT_TOKEN" \
    -e AI_MEMORY_AUTH__SECURE_COOKIE=true \
    -e AI_MEMORY_ALLOWED_HOSTS="memory.example.com,localhost,127.0.0.1" \
    akitaonrails/ai-memory:latest

  2. הגדר ובדוק TLS לפני חיבור לקוחות

    הצב פרוקסי הפוך באותו מארח, שמפנה HTTPS מהדומיין שלך אל 127.0.0.1:49374. פעל לפי הגדרת TLS ובדוק את האישור ממחשב נייד לפני שליחת מפתחות. טוקן bearer מאמת; הוא אינו מצפין תעבורה.

  3. יוצרים את האנשים

    השתמש במעטפת השרת שבה משתני root עדיין מיוצאים. הסיסמה הזמנית מוצגת פעם אחת ויש להחליף אותה בכניסה הראשונה. הפקודה אינה מנפיקה מפתח API. מדריך המשתמשים מסביר את זהות root והגדרת הכניסה בדפדפן.

    טרמינל
    ai-memory user add-human --username alice --email alice@home --name "Alice Smith"

  4. נותנים לכל אדם מפתח API

    הסוד aim_ מוצג פעם אחת. ai-memory api-key rotate <id> ו-ai-memory api-key revoke <id> נכנסים לתוקף מיד.

    טרמינל
    ai-memory api-key add --username alice --label codex-laptop

  5. מפנים כל מחשב אל השרת

    התקן את ה־CLI בכל מחשב נייד. החלף את הדומיין והמפתח בכתובת HTTPS שלך ובמפתח שהונפק לאדם הזה. ב־Unix מתקין ההוקים שומר את הטוקן בקובץ נגיש לבעלים בלבד; פקודות ההוקים שנוצרות אינן מכילות אותו. --as-user מסמן את ההתקנה ואינו מעניק הרשאות.

    בכל מחשב נייד
    # החלף את מציין המקום במפתח aim_ שהונפק לאדם הזה; לעולם אל תשתמש ב־ROOT_TOKEN
USER_API_KEY='aim_REPLACE_WITH_ISSUED_KEY'
export AI_MEMORY_SERVER_URL="https://memory.example.com"
export AI_MEMORY_AUTH_TOKEN="$USER_API_KEY"

ai-memory install-mcp   --client claude-code --apply
ai-memory install-hooks --apply --agent claude-code \
    --as-user alice --auth-token "$USER_API_KEY"

# ואז מפעילים כרגיל
ai-memory run claude

להמשך קריאה

נתקעתם באחד הצעדים?

ב-cookbook של ההתקנה ב-GitHub יש את הפקודות לכל סוכן, שרתים מרוחקים ו-Windows. ה-issue tracker פתוח.

להתקנהכוכב ב-GitHub