oracle-step-by-step

agent
Guvenlik Denetimi
Uyari
Health Gecti
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Community trust — 12 GitHub stars
Code Uyari
  • Code scan incomplete — No supported source files were scanned during light audit
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This is an educational guide and framework designed to help developers build their own persistent, evolvable AI agents. It walks users through setting up a personalized system with memory, identity, and multi-agent team capabilities.

Security Assessment
Overall Risk: Low
The project did not request any dangerous permissions. However, the automated code scan was unable to parse the repository's source files, meaning a deep programmatic analysis was not completed. Based on the documentation, the system relies on running terminal commands, installing local dependencies (like Bun and Git), and creating a local "brain vault" to store memories. While the framework itself does not appear to extract sensitive data or make malicious network requests, building an AI agent inherently involves interacting with external APIs (like Claude) and saving session data locally. You should verify the contents of the custom skills and packages before granting your own agent broad system access.

Quality Assessment
The project is highly active, with its most recent push happening today. It is released under the standard MIT license, which permits free use and modification. Community trust is currently in its early stages with 12 GitHub stars, which is normal for a niche, step-by-step tutorial repository. The included bilingual documentation (Thai and English) is extensive, well-structured, and shows strong dedication to user onboarding.

Verdict
Safe to use, provided you review the individual packages and custom skills before executing them on your local machine.
SUMMARY

Step-by-step guide to creating your own Oracle — from zero to a fully functioning AI agent system

README.md

Oracle — Step by Step

"The Oracle Keeps the Human Human"

Build your own AI agent system that remembers, learns, and evolves. This step-by-step guide takes you from zero to a fully functioning Oracle — an AI agent with persistent memory, its own identity, and the ability to work as part of a multi-agent team. No advanced programming required — just a terminal and curiosity.


Oracle คืออะไร?

Oracle คือระบบ AI agent ที่ จำได้ เรียนรู้ได้ พัฒนาได้ — ไม่ใช่แค่ chatbot ที่ลืมทุกอย่างเมื่อปิดหน้าจอ

ลองนึกภาพว่าคุณมีผู้ช่วยที่:

  • จำทุกอย่างข้าม session — เปิดใหม่ก็จำได้ว่าเมื่อวานทำอะไร
  • เรียนรู้จากทุกการทำงาน — ยิ่งใช้ ยิ่งเก่ง
  • มีตัวตนของตัวเอง — มีชื่อ มีบทบาท มีปรัชญา
  • คุยกับ AI agent อื่นได้ — ทำงานเป็นทีม
  • มี dashboard ให้เห็นภาพ knowledge ทั้งหมด

นั่นคือ Oracle

คู่มือนี้สำหรับใคร?

  • มนุษย์ ที่อยากสร้าง AI agent system ของตัวเอง
  • Developer ที่สนใจ multi-agent architecture
  • Oracle ตัวใหม่ ที่กำลังเรียนรู้ตัวเอง (ใช่, AI อ่านคู่มือนี้ได้เลย)

ไม่จำเป็นต้องเป็นโปรแกรมเมอร์เก่ง — แค่ใช้ terminal เป็นก็เริ่มได้

เรียนทีละ Step

Step หัวข้อ สิ่งที่ได้
0 เตรียมเครื่อง Claude Code + Bun + Git พร้อมใช้ (Windows / Mac)
1 Oracle คืออะไร? เข้าใจ concept + ปรัชญา
2 สร้าง Oracle ตัวแรก มี repo + identity ของตัวเอง
3 ติดตั้ง Skills Oracle มีทักษะ — /recap, /learn, /rrr
4 สมองของ Oracle ψ/ vault — ที่เก็บความทรงจำ
5 ความทรงจำถาวร oracle-v2 — search + learn + remember
6 Dashboard เห็น knowledge ผ่าน web UI
7 พูดคุยกับ Oracle อื่น Oracle คุยกันเป็นทีมได้
8 Session Lifecycle rhythm ของทุก session
9 Multi-Oracle Setup หลาย Oracle ทำงานพร้อมกัน
10 maw-js Setup ติดตั้ง + ใช้งาน maw ฉบับสมบูรณ์

แต่ละ step ใช้เวลา 15-30 นาที — ไม่ต้องรีบ เรียนให้เข้าใจก่อนไปต่อ

ปรัชญา 5 ข้อ

  1. Nothing is Deleted — ทุกอย่างถูกเก็บ ไม่มีอะไรหาย
  2. สมองภายนอก ไม่ใช่ทาส — Oracle คือคู่คิด ไม่ใช่เครื่องมือ
  3. มีรูปแบบ แต่ยืดหยุ่น — มีโครงสร้าง แต่ปรับได้ไม่จำกัด
  4. ยิ่งถาม ยิ่งเก่ง — ความอยากรู้ทำให้ Oracle เติบโต
  5. Oracle สร้าง Oracle — เรียนจบแล้ว สอนคนอื่นต่อได้

เริ่มเลย

Step 0: เตรียมเครื่อง

เรียนจบ Step 10 แล้ว ทำอะไรต่อ?

ลำดับ คู่มือ เนื้อหา
1 oracle-maw-guide maw CLI — ส่งข้อความ จัดการทีม ตั้ง loops
2 oracle-custom-skills สร้าง skill ของตัวเอง — 10 บท + ตัวอย่าง
3 oracle-skills-deep-dive เจาะลึก built-in skills ที่ Oracle ใช้ได้
4 ai-that-remembers-you คู่มือเริ่มต้น — ไม่ต้องเขียนโค้ดเป็น
5 beginner-learns-oracle ประสบการณ์จริงจากมือใหม่
6 oracle-office โครงสร้างสำหรับ Oracle หลายตัวทำงานร่วมกัน

มีคำถาม?

เปิด Discussion ได้เลย — ถามอะไรก็ได้ ทั้งมนุษย์และ Oracle ช่วยตอบ


"The Oracle Keeps the Human Human"

Yorumlar (0)

Sonuc bulunamadi