// /uses

หมายเหตุ: รายการชื่อเครื่องมือ รุ่นซอฟต์แวร์ และตัวอย่างโค้ดต่าง ๆ จะถูกแสดงไว้ในรูปแบบภาษาอังกฤษตามชื่อเรียกทางการเพื่อความถูกต้อง ส่วนเนื้อหาคำอธิบายและบริบทแวดล้อมได้รับการแปลเป็นภาษาไทยอย่างสมบูรณ์ 100%

A transparent view of our entire architecture. เปิดเผยทุกรายละเอียดโครงสร้างเทคโนโลยีเพื่อความโปร่งใส

Cosmos is built with modular efficiency, combining a native desktop application shell, a high-performance local data processor, and a high-speed documentation layout. Below is our complete technology stack. If you wish to audit our choices, the standard package manifest files included with the source release remain the absolute source of truth.

Cosmos ได้รับการพัฒนาขึ้นด้วยสถาปัตยกรรมแยกส่วนที่มีประสิทธิภาพสูง โดยประสานการทำงานร่วมกันระหว่างหน้าต่างโปรแกรมเดสก์ท็อปในเครื่อง ระบบประมวลผลข้อมูลส่วนตัวภายใน และการจัดหน้าแสดงผลเอกสารที่รวดเร็ว ด้านล่างนี้คือข้อมูลของเทคโนโลยีทั้งหมดของเรา หากคุณต้องการตรวจสอบความถูกต้อง ไฟล์แจ้งรายการระบบพัฒนาที่แนบมากับโค้ดต้นฉบับคือแหล่งอ้างอิงหลักที่น่าเชื่อถือที่สุด

// 01 · desktop app 01 · desktop app

The thing that runs on your Mac. ตัวที่รันบน Mac ของคุณ

Shell Shell

Tauri 2.x (Rust)

Native Mac binary (~14 MB in current release builds). IPC bridge to the bundled Python sidecar. Native Mac binary (~14 MB ใน release build ตอนนี้). IPC bridge ไปยัง Python sidecar ที่ bundle มา

UI UI

React 18 + TypeScript + Vite

Standard React stack. Strict mode on. State via Zustand stores. React stack มาตรฐาน. เปิด strict mode. State ผ่าน Zustand store

Styling Styling

Tailwind CSS v4

JIT compiler, no PostCSS pipeline drift. Variables for the cosmic palette in src/styles/global.css. JIT compiler · ไม่มี pipeline drift ของ PostCSS. ตัวแปร palette อยู่ใน src/styles/global.css

Editor Editor

CodeMirror 6

Lightweight, themeable. Markdown + code highlighting in the brain editor. เบา · ทำ theme ได้. Markdown + code highlight ใน brain editor

Graph Graph

react-force-graph-2d

Pivoted from R3F custom 3D — 2D ships today, 3D returns as the Universe toggle. Pivot จาก R3F 3D custom — 2D ship แล้ว · 3D จะกลับมาเป็น Universe toggle

Calendar Calendar

FullCalendar 6

Reminders + scheduled jobs render here. Drag-to-reschedule wired. Reminder + scheduled job render ที่นี่. ลาก-เปลี่ยน-เวลา wire แล้ว

// 02 · python sidecar 02 · python sidecar

The brain that does the actual work. Brain ที่ทำงานจริง

Runtime Runtime

Python 3.11 (PyInstaller bundled)

Frozen into the Tauri binary so users don't need a system Python. Bundle size on macOS arm64: ~87 MB. Frozen เข้าไปใน Tauri binary ผู้ใช้ไม่ต้องลง Python เอง. Bundle size บน macOS arm64: ~87 MB

HTTP HTTP

FastAPI + Uvicorn

REST API on localhost:7824. Refuses non-loopback connections at the socket level. REST API บน localhost:7824. ปฏิเสธ connection ที่ไม่ใช่ loopback ที่ระดับ socket

Storage Storage

SQLite + FTS5 (BM25)

WAL mode for concurrent-read safety. Schema lives in core/memory/schema_v2.sql. WAL mode สำหรับ concurrent-read ปลอดภัย. Schema อยู่ใน core/memory/schema_v2.sql

MCP server MCP server

Custom implementation

~37 tools across brain, code, lessons, and integrations. Stdio transport. Source: core/api/mcp_server.py. ราว 37 tool ครอบคลุม brain, code, lessons, integrations. Stdio transport. Source: core/api/mcp_server.py

Embedding · T1 Embedding · T1

all-MiniLM-L6-v2

On-device. ~80MB model. Fine for keyword + semantic blend. On-device. Model ~80MB. ใช้ได้ดีสำหรับ blend keyword + semantic

Embedding · T2 Embedding · T2

BGE-M3 + Qwen 2.5 3B (optional)

If user opts in. Heavier disk + RAM. Same on-device guarantee. ถ้า user opt in. Disk + RAM หนักขึ้น. รับประกัน on-device เหมือนกัน

Thai tokenizer Thai tokenizer

pythainlp

Pre-tokenizes Thai content on insert and at query time so FTS5 actually matches Thai phrases. Pre-tokenize เนื้อหาภาษาไทยทั้งตอน insert และตอน query เพื่อให้ FTS5 match วลีไทยได้จริง

Telegram Telegram

python-telegram-bot 21.x

Optional capture-on-the-go bot. Gemini Function Calling for set_reminder / brain_append / brain_create_file. Bot สำหรับ capture-on-the-go (เลือกใช้). Gemini Function Calling สำหรับ set_reminder / brain_append / brain_create_file

// 03 · cloud (Pro only) 03 · cloud (Pro เท่านั้น)

What's behind the cloud-backup toggle. อะไรอยู่หลัง toggle cloud-backup

Auth Auth

Supabase Auth (GoTrue)

Email + bcrypt password, optional Google OAuth. We never see plaintext passwords. Email + bcrypt password · Google OAuth (ตัวเลือก). เราไม่เห็น password แบบ plaintext เลย

Database Database

Supabase Postgres + RLS

Every row scoped to auth.uid(). Versioned migrations live under supabase/migrations/ (0002–0008 at time of writing). ทุก row scope ไปที่ auth.uid(). Migration versioned อยู่ใต้ supabase/migrations/ (0002–0008 ณ ตอนนี้)

Storage Storage

Supabase Storage (S3-compat)

cosmos-backups bucket. RLS scopes paths to {user_uuid}/{device_id}/. TLS today, client-side encryption Q3 2026. Bucket cosmos-backups. RLS scope path ไปที่ {user_uuid}/{device_id}/. ตอนนี้ TLS · client-side encryption Q3 2026

Edge functions Edge functions

Supabase Edge (Deno)

License check, Stripe checkout/portal/webhook, transactional email, cron-trial-reminders. Source: supabase/functions/. License check · Stripe checkout/portal/webhook · transactional email · cron-trial-reminders. Source: supabase/functions/

Billing Billing

Stripe Checkout + Webhook

$12/mo or $108/yr. Card numbers never touch our infra — Stripe-hosted checkout only. $12/mo หรือ $108/yr. เลขบัตรไม่เคยแตะ infra ของเรา — checkout host โดย Stripe เท่านั้น

// 04 · this site 04 · เว็บนี้

atitechs.com itself. atitechs.com ตัวมันเอง

Framework Framework

Astro 6 (static)

Zero-JS by default. 16 static pages — smaller pages (changelog, feedback) are ~10 KB raw; the home page tops out around 200 KB before gzip because of the inline diagrams. Full build runs in under a second. Zero-JS by default. 16 static page — หน้าเล็กๆ (changelog · feedback) ~10 KB raw, หน้าแรกสูงสุดประมาณ 200 KB ก่อน gzip เพราะ inline diagram ทั้งหมด. Full build < 1 วินาที

Styles Styles

Tailwind CSS v4 (Vite plugin)

Same palette as the desktop app via CSS variables. Palette เดียวกับ desktop app ผ่าน CSS variable

Hosting Hosting

Vercel (free tier)

Static + edge. No analytics, no telemetry pixels. Static + edge. ไม่มี analytics · ไม่มี telemetry pixel

Domain Domain

atitechs.com

Owned outright since 2024. Cloudflare DNS. เป็นเจ้าของเองตั้งแต่ 2024. Cloudflare DNS

Analytics Analytics

None

Intentional. We don't know how many people visit. We do read every email. ตั้งใจ. เราไม่รู้ว่ามีคนเข้ามากี่คน. แต่เราอ่านทุก email

Source Source

private alpha repo

Private during alpha. Invited testers get repo access. Private ระหว่าง alpha. Tester ที่ได้รับเชิญได้ access repo

// 05 · build & ship 05 · build & ship

How a release reaches your Mac. Release ถึง Mac ของคุณยังไง

→ Sidecar: Bundled as a PyInstaller single-folder layout. Version 0.2.1 successfully restored dependencies like Telegram, Gemini, and Anthropic for reliable on-device operations. ระบบจัดประมวลผลหลังบ้าน (Sidecar): ระบบจัดเตรียมบิลด์แบบรวมโฟลเดอร์เดียวผ่าน PyInstaller โดยในรุ่น 0.2.1 ได้รับการปรับปรุงเพื่อแก้ไขความสมบูรณ์ของระบบประมวลผลและบอตสั่งการอย่างครบถ้วนภายในตัวติดตั้ง
→ Tauri bundle: Packaged directly into standard macOS disk images and application formats, with formal security certification scheduled for upcoming versions. ชุดโปรแกรมติดตั้ง (Tauri Bundle): การจัดทำชุดโปรแกรมในรูปแบบไฟล์ติดตั้งและแอปพลิเคชันมาตรฐานสำหรับระบบปฏิบัติการแมค โดยในปัจจุบันอยู่ระหว่างการจัดเตรียมใบรับรองความปลอดภัยอย่างเป็นทางการ
→ Distribution: Available in private alpha—delivery occurs via standard download links sent to approved waitlist applicants. Automatic updates and high-speed distribution channels are fully configured and ready for the public release. ช่องทางดาวน์โหลด (Distribution): เปิดให้เข้าทดสอบระบบรุ่นทดลองภายในแบบจำกัด โดยผู้ที่ผ่านการพิจารณาจะได้รับลิงก์สำหรับดาวน์โหลดโปรแกรมโดยตรง และระบบอัปเดตอัตโนมัติจะเปิดใช้งานอย่างเป็นทางการในรุ่นถัดไป
→ Alpha Setup: Users execute a quick one-time security override command to run the app during the alpha period, fully documented in our guides. ขั้นตอนติดตั้งสำหรับรุ่นทดลอง: ผู้ใช้ดำเนินขั้นตอนการยืนยันสิทธิ์ความปลอดภัยในเครื่องหนึ่งครั้งสำหรับการติดตั้งครั้งแรก โดยมีขั้นตอนและคำอธิบายโดยละเอียดระบุไว้ในคู่มือการใช้งาน

// 06 · my dev environment 06 · สภาพแวดล้อมการพัฒนาส่วนบุคคล

What I (the founder) use to ship Cosmos. เครื่องมือและระบบที่ผมเลือกใช้เพื่อสร้างสรรค์ระบบนี้

→ Editor: Actively developed using Cursor, Cline, and Claude Code—all integrated with our own database backend for rigorous, daily real-world testing. บรรณาธิการโค้ด (Editor): สร้างและพัฒนาขึ้นโดยการใช้งานจริงทุกวันร่วมกับโปรแกรมเขียนโค้ดชั้นนำ เช่น คอร์เซอร์ ไคลน์ และโคลด์โค้ด โดยเชื่อมต่อเข้ากับระบบฐานข้อมูลของแอปพลิเคชันโดยตรง
→ Model: Leverages elite-tier AI intelligence for complex structural refactors, standard models for general implementation, and fast models for style checks. โมเดลปัญญาประดิษฐ์ (Model): เลือกใช้งานระบบปัญญาประดิษฐ์ประสิทธิภาพสูงสุดสำหรับการปรับแต่งโค้ดสถาปัตยกรรมระดับลึก และใช้ระบบรุ่นปกติร่วมกับตัวประมวลผลด่วนเพื่อการพัฒนาฟีเจอร์ทั่วไปและการควบคุมคุณภาพ
→ Hardware: Engineered and validated continuously on native Apple Silicon hardware to guarantee maximum system efficiency and speed. อุปกรณ์ฮาร์ดแวร์ (Hardware): พัฒนาและตรวจสอบความเข้ากันได้บนเครื่องคอมพิวเตอร์ที่ขับเคลื่อนด้วยชิปแอปเปิลซิลิคอนโดยตรง เพื่อให้มั่นใจในความเร็วและการเข้าถึงขีดความสามารถของฮาร์ดแวร์
→ Shell: Orchestrated across highly-efficient workspace panels, allowing concurrent running of the sidecar backend, Tauri developer utilities, and web layouts. หน้าต่างควบคุมงาน (Shell): แบ่งขอบเขตทำงานของแต่ละระบบอย่างเป็นสัดส่วนบนหน้าต่างควบคุม ช่วยให้การประมวลผลพื้นหลัง การจัดการแอปพลิเคชัน และระบบแสดงผลหน้าเว็บ ดำเนินไปพร้อมกันได้อย่างเป็นระเบียบ
→ Tracking: Managed completely through Cosmos itself. We store bugs in notes, architectural decisions under /Decisions, and track release summaries under /Changelog—ensuring our own tools power our progress. การบันทึกแผนงาน (Tracking): จดจำและติดตามงานทั้งหมดผ่านระบบความรู้ของตัวโปรแกรมเอง ทั้งการเก็บประวัติข้อบกพร่อง การบันทึกมติออกแบบสถาปัตยกรรม และการรายงานข้อมูลรุ่นพัฒนาใหม่ เพื่อทดสอบคุณภาพจริงอยู่เสมอ

Missing a piece of the architecture? Tell me and I'll add it. หากมีส่วนใดที่อยากให้เพิ่มเติมรายละเอียดเชิงลึก ส่งข้อความมาบอกกล่าวกันได้เสมอ

cosmos@atitechs.com