Mã nguồn mở · Ứng dụng máy tính
Giao cho AI. Nắm rõ tiến độ.
Giao cho AI. Nắm rõ tiến độ.Today là một màn hình duy nhất cho mọi dự án của bạn. Nó cho thấy việc đang chờ bạn trả lời, việc cần làm lại, việc đang chạy và việc sắp tới.
- Giấy phép MIT, kèm các mô-đun Enterprise Edition theo BUSL-1.1
- Tải miễn phí. Cần Docker Desktop và Claude Code.
- macOS, Windows, Linux
Một yêu cầu từ trợ lý đến, bạn chấp thuận, trợ lý quay lại làm việc, một tác vụ hoàn thành và kế hoạch tiến lên.
Today · Chủ nhật, 4 tháng 10
Một trợ lý đang chờ bạn trả lời
Đã chờ 1 phút.
17/38 tác vụ đã xong
trên 3 kế hoạch được theo dõi ở đây
- 4 đang chạy
- 1 chờ bạn trả lời
- 1 bị chặn
- 15 sắp tới
Chờ bạn1
- Câu hỏiBữa tối chào mừng và thực đơnSự kiện
Đơn vị ăn uống đưa ra hai thực đơn cho 24 khách. Tôi nên xác nhận thực đơn nào?
Cuộc trò chuyện tự do: không gắn với kế hoạch nào
Mở cuộc trò chuyện
Cần làm lại1
- Chuẩn bị hồ sơ xin tài trợTác vụ bị chặnTài trợđã 2 ngày$2.405/121 bị chặn
Tiếp tục sẽ chạy lại 2 tác vụ; 5 tác vụ đã xong
1 tác vụ bị chặn sẽ bị bỏ qua
- Xin thư xác nhận có chữ ký của đối tác
Hãy gỡ chặn trước khi tiếp tục: tác vụ bị chặn sẽ bị bỏ qua.
Tác vụ của tôi
- Xác nhận tiền đặt cọc địa điểmĐã xongTổ chức chuyến đi nhóm mùa thu
- Gửi thông báo ngày diễn ra cho kháchĐã xongTổ chức chuyến đi nhóm mùa thu
- Chọn thực đơn cho bữa tối chào mừngBữa tối chào mừng và thực đơn
- Đặt vé tàuTổ chức chuyến đi nhóm mùa thu
Đang chạy2
- Tổ chức chuyến đi nhóm mùa thu1h 16m$5.8510/183 đang chạy3 trợ lý đang làm việc nàySự kiện
- Bữa tối chào mừng và thực đơn28m$2.052/81 chờ bạn trả lời1 đang chạy1 tác vụ đang chờ bạn trả lờiSự kiện
Trợ lý
1 đang chờ bạn trả lời · 3 đang làm việc
$5.50
Đề xuất 1
- Chia sẻ bảng ngân sách với cả nhóm
Quyết định 1
- Tổ chức chuyến đi vào tháng 11 thay vì tháng 10
Ghi chú cần xem lại 1
- Nhà nghỉ đóng cửa vào thứ Hai
Một yêu cầu từ trợ lý đến, bạn chấp thuận, trợ lý quay lại làm việc, một tác vụ hoàn thành và kế hoạch tiến lên.
Today · Chủ nhật, 4 tháng 10
Một trợ lý đang chờ bạn trả lời
Đã chờ 1 phút.
17/38 tác vụ đã xong
trên 3 kế hoạch được theo dõi ở đây
Chờ bạn1
- Câu hỏiBữa tối chào mừng và thực đơnSự kiện
Đơn vị ăn uống đưa ra hai thực đơn cho 24 khách. Tôi nên xác nhận thực đơn nào?
Cuộc trò chuyện tự do: không gắn với kế hoạch nào
Mở cuộc trò chuyện
Đang chạy2
- Tổ chức chuyến đi nhóm mùa thu1h 16m$5.8510/183 đang chạy3 trợ lý đang làm việc nàySự kiện
- Bữa tối chào mừng và thực đơn28m$2.052/81 chờ bạn trả lời1 đang chạy1 tác vụ đang chờ bạn trả lờiSự kiện
Trợ lý
1 đang chờ bạn trả lời · 1 đang làm việc
$5.50
Xây trên các công cụ mở mà bạn có thể kiểm tra
31
công cụ MCP
Mỗi công cụ nhận một tham số action: plan, task, note, decision, code…
17
ngữ pháp tree-sitter
Rust, TypeScript, Python, Go, Java, C, C++ và nhiều ngôn ngữ khác, được phân tích vào đồ thị.
3
nền tảng máy tính
Ứng dụng Tauri có cho macOS, Windows và Linux.
Vấn đề
Ba điều trục trặc khi các trợ lý AI của bạn không có chung một bộ nhớ
Cuộn xuống từng điều. Trước hết bạn thấy chuyện gì xảy ra. Sau đó bạn thấy Project Orchestrator giữ lại gì để chuyện đó không lặp lại.
1 / 3
Các trợ lý của bạn bắt đầu từ số không ở mỗi cuộc trò chuyện
Bạn giải thích mục tiêu, sở thích và những gì đã quyết định. Rồi cuộc chat đóng lại và trợ lý quên hết. Lần sau, bạn lại giải thích từ đầu.
Với Project Orchestrator
PO giữ ghi chú và quyết định của bạn cùng dự án. Trước một tác vụ, trợ lý tra cứu những gì liên quan. Nó tìm theo ý nghĩa, không chỉ theo đúng từ ngữ.
Bên trong
Ghi chú và quyết định được lưu trong một đồ thị ở Neo4j. note(action: "search_semantic") tìm chúng theo ý nghĩa, nhờ Meilisearch.
2 / 3
Các trợ lý sửa cùng một thứ cùng một lúc
Hai trợ lý chỉnh sửa cùng một tài liệu. Một trợ lý bắt đầu một việc trước khi việc nó cần xong. Thế là bạn làm từng việc một, và mất đúng khoảng thời gian bạn muốn tiết kiệm.
Với Project Orchestrator
Một kế hoạch cho biết tác vụ nào phụ thuộc tác vụ nào. Các tác vụ không phụ thuộc nhau chạy cùng lúc. Các tác vụ còn lại chờ những tác vụ chúng cần.
Bên trong
PO tính các đợt từ quan hệ phụ thuộc giữa các tác vụ bằng plan(action: "get_waves"). Các tác vụ khai báo cùng những tệp bị ảnh hưởng sẽ được tách vào các đợt khác nhau.
3 / 3
Lý do đằng sau các lựa chọn của bạn bị mất
Vì sao chọn địa điểm này, vì sao ngân sách đó. Lý do chỉ nằm trong đầu một người hoặc trong một tin nhắn cũ. Trợ lý tiếp theo hỏi lại, hoặc hoàn tác lựa chọn.
Với Project Orchestrator
Một quyết định được lưu kèm lý do và phạm vi ảnh hưởng. Trợ lý tiếp theo tìm thấy nó, cùng trạng thái của nó, trước khi thay đổi bất cứ điều gì liên quan.
Bên trong
Một quyết định được nối với các tác vụ, kế hoạch hoặc tệp mà nó ảnh hưởng bằng decision(action: "add_affects"), và có một trạng thái như proposed hoặc accepted.
Một kế hoạch, hai cách xem
Làm nhiều tác vụ cùng lúc, không phải lần lượt từng việc
Có tác vụ phải chờ một tác vụ khác xong trước. Các tác vụ còn lại có thể bắt đầu cùng nhau, thành một nhóm gọi là đợt. Xem cùng một kế hoạch dưới dạng sơ đồ liên kết hoặc bảng nhiều cột.
Organize the team weekend
0/8 done (0%)
- Wave 12 in parallel, 6 min
- Wave 22 in parallel, 14 min
- Wave 33 in parallel, 12 min
- Wave 41 in parallel, 7 min
Shortlist three venues near a train station
Collect everyone’s availability
Book the venue
Write the invitation
Plan the two-day schedule
Arrange meals and transport
Send invitations and track replies
Share the final plan with the team
Một trợ lý, làm từng tác vụ một
71 phút
Theo từng đợt
0 phút / 39
Thời gian tiết kiệm
—
Hãy chạy kế hoạch để đo
Kịch bản minh họa: thời lượng là số phút trợ lý được viết riêng cho bản demo này, không phải kết quả đo hiệu năng.
Nó làm được gì
Dự án, kế hoạch và quyết định của bạn ở một nơi
Dự án có mã hoặc không có mã, kế hoạch, các trợ lý làm việc cùng nhau, bộ nhớ về những gì đã quyết định, và chỉ chia sẻ khi bạn đồng ý. Từng phần được trình bày bên dưới.
Bộ nhớ
PO nhớ những gì bạn quyết định và học được
Ghi chú, quyết định và các liên kết giữa chúng luôn gắn với dự án của bạn. PO tìm lại chúng khi cần. Cuộn xuống để xem một bộ nhớ lớn dần.
Ví dụ tự dựng: một dự án sự kiện nhỏ. Các tên trong đồ thị chỉ là minh họa, không phải dữ liệu của bạn. Màu sắc và hình dạng giống đồ thị trong sản phẩm.
1 trên 5
Các tệp của bạn trở thành những chấm
PO bắt đầu từ những gì có trong dự án: tài liệu, bảng tính, tệp. Mỗi tệp là một chấm xanh dương.
2 trên 5
Kế hoạch và tác vụ tham gia
Kế hoạch và tác vụ được thêm vào cùng một bức tranh. Mỗi tác vụ được nối với các tệp nó chạm đến.
3 trên 5
Ghi chú và quyết định luôn có liên kết
Điều bạn học được trở thành ghi chú. Điều bạn quyết định trở thành quyết định. Cả hai vẫn được nối với các tệp và với nhau.
4 trên 5
Những thứ liên quan tụ lại với nhau
Các mục cùng chủ đề dịch lại gần nhau. Bạn thấy ngay các chủ đề chính của dự án.
5 trên 5
PO tìm câu trả lời theo các liên kết
Bạn đặt một câu hỏi. PO tìm các ghi chú khớp (màu lục lam). Rồi nó đi theo các liên kết đến những mục liên quan (màu tím), kể cả khi từ ngữ khác nhau.
Bên trong: tên của các liên kết
Đây là tên mà sản phẩm dùng cho các liên kết trong đồ thị của nó. Bạn không cần biết chúng để dùng PO.
- CONTAINSMột kế hoạch chứa các tác vụ của nó.
- IMPORTSMột tệp dùng một tệp khác.
- AFFECTSMột tác vụ chạm đến một tệp.
- CO_CHANGEDHai tệp thường thay đổi cùng nhau, thấy được trong lịch sử của mã.
- SYNAPSEMột liên kết giữa ghi chú, quyết định và tệp. Các liên kết không ai dùng sẽ mờ dần.
Cách hoạt động
Từ một câu nói đến công việc đã được kiểm tra
Lập kế hoạch, sắp thứ tự, nhớ lại, chạy, kiểm tra, ghi nhớ. Đây là những gì PO làm cho mọi kế hoạch.
1 · Lập kế hoạch
Bạn nói điều bạn muốn, bạn nhận một kế hoạch
Bạn mô tả kết quả trong một câu. Trợ lý biến nó thành một kế hoạch gồm các tác vụ. Mỗi tác vụ có các bước, và mỗi bước cho biết cách kiểm tra là đã xong.
2 · Sắp thứ tự
Các tác vụ không phụ thuộc nhau được làm cùng nhau
PO sắp xếp các tác vụ. Một tác vụ chỉ chờ những tác vụ nó cần. Tất cả các tác vụ khác có thể bắt đầu ngay, cùng lúc.
3 · Nhớ lại
Trợ lý tra cứu những gì dự án đã biết
Trước mỗi tác vụ, trợ lý đọc các ghi chú và quyết định có liên quan. Nhờ vậy nó không hỏi lại những câu cũ.
4 · Chạy
Các trợ lý làm tác vụ, từng nhóm một
Mỗi tác vụ được giao cho một trợ lý riêng. Các tác vụ trong một nhóm chạy cùng lúc, còn nhóm kế tiếp phải chờ.
5 · Kiểm tra
Một nhóm xong khi các phép kiểm tra đều đạt
Trước khi nhóm kế tiếp bắt đầu, PO kiểm tra công việc. Các bước phải được đóng và không tệp nhạy cảm nào được lọt vào thay đổi. Với dự án có mã, PO còn kiểm tra rằng nó vẫn build được.
6 · Ghi nhớ
Những gì đã học được lưu lại cho lần sau
Khi công việc xong, những gì đã quyết định và học được sẽ được ghi ngược vào bộ nhớ dự án. Kế hoạch kế tiếp bắt đầu với chúng.
Những gì giai đoạn 6 lưu lại sẽ được giai đoạn 3 nhớ lại ở kế hoạch kế tiếp.
Theo dõi một lượt chạy, từng giai đoạnDùng thử
Xem một trợ lý làm việc cùng PO
Chọn một yêu cầu. Bạn sẽ thấy câu trả lời bằng lời đơn giản, cùng các lệnh gọi mà trợ lý gửi đến PO ở phía sau. Mở một lệnh gọi để xem chi tiết.
Two notes apply: the place must be close to a train station, and last year the menu had nothing vegetarian. I will write the plan around both.
The plan has 3 tasks in 2 waves. The shortlist and the date poll do not depend on each other, so they happen at the same time. Booking waits for both.
Bản demo mô phỏng: câu trả lời được viết sẵn và không có máy chủ nào được liên hệ. Các lệnh gọi và tham số của chúng là thật.
PO sẽ đi về đâu
Mỗi người giữ PO của mình. Tổ chức chia sẻ những gì họ chọn.
Hãy hình dung một công ty: một kho tri thức chung, các nhóm, con người và quyền truy cập. Một phần của nền tảng đã chạy hôm nay. Lớp tổ chức nằm trong dự kiến.
Minh họa với những người được tự dựng.
Đã có
Một PO cho mỗi người: danh tính riêng, đăng nhập, không gian làm việc, két bảo mật
Đang làm
Chia sẻ giữa các phiên bản PO, chỉ khi bạn đồng ý
Dự kiến
Tri thức chung, nhóm và vai trò, quyền truy cập
Tải về
Tải Project Orchestrator
Chọn ứng dụng cho máy tính của bạn. Bạn không cần tạo tài khoản Project Orchestrator.
Trước khi bắt đầu
- Docker Desktop. Ứng dụng dùng nó để chạy các dịch vụ cần thiết, và có thể giúp bạn cài đặt nó.
- Claude Code, thành phần chạy phần chat. AI không đi kèm: bạn cần có tài khoản Claude của riêng mình.
- Lần mở đầu tiên mất vài phút. Một trình hướng dẫn thiết lập sẽ dẫn bạn đi và tải những gì còn thiếu.
Windows 2
- Windows, trình cài đặt57,7 MBTrình cài đặt thông thường cho Windows 64 bit. Nó mở một trình hướng dẫn cài đặt.Project.Orchestrator_0.0.16_x64-setup.exe
- Windows, MSI75,9 MBCùng ứng dụng đó dưới dạng gói MSI, để triển khai có quản lý trên Windows 64 bit.Project.Orchestrator_0.0.16_x64_en-US.msi
Linux 5
- Linux, AppImage126 MBMột tệp chạy được trên hầu hết các bản phân phối Linux (x86_64).Project.Orchestrator_0.0.16_amd64.AppImage
- Debian và Ubuntu, x86_6458,1 MBGói cài bằng dpkg hoặc apt.Project.Orchestrator_0.0.16_amd64.deb
- Debian và Ubuntu, arm6452,7 MBGói cài bằng dpkg hoặc apt, cho máy ARM64.Project.Orchestrator_0.0.16_arm64.deb
- Fedora và RHEL, x86_6436,7 MBGói cài bằng dnf hoặc rpm.project-orchestrator-0.0.16-1.x86_64.rpm
- Fedora và RHEL, arm6430,7 MBGói cài bằng dnf hoặc rpm, cho máy ARM64.project-orchestrator-0.0.16-1.aarch64.rpm
orchestrator, orch và mcp_server, đã kèm giao diện web. Bản nhẹ hơn không có giao diện web nằm ở trang bản phát hành.
Dành cho nhà phát triển: dòng lệnh
Homebrew
Mac và Linux. Cài orchestrator, orch và mcp_server.
brew install this-rs/tap/project-orchestratorTập lệnh cài đặt
Mac và Linux. Bản phát hành mới nhất vào ~/.local/bin. Thêm --no-frontend để dùng bản nhẹ.
curl -fsSL https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.sh | shPowerShell
Windows. Cài vào %LOCALAPPDATA%\orchestrator\bin.
irm https://raw.githubusercontent.com/this-rs/project-orchestrator/main/install.ps1 | iexDocker
Image cho amd64 và arm64, kèm giao diện web.
docker pull ghcr.io/this-rs/project-orchestrator:latest# API only, no dashboard: a version tag with the -api suffix# docker pull ghcr.io/this-rs/project-orchestrator:0.0.16-apiMáy chủ cần gì
- Bộ nhớ dự án
- Neo4j 5
- Tìm kiếm
- Meilisearch
- Bus sự kiện
- NATS (tùy chọn)
- Môi trường chạy
- Docker 20.10+
Ứng dụng máy tính tự khởi động Neo4j và Meilisearch trong Docker cho bạn. Với dòng lệnh, một lệnh compose là đủ: làm theo hướng dẫn bắt đầu nhanh.
Cài đặt
Từ tải về đến lần mở đầu tiên
Không cần terminal. Trước hết bạn cài hai công cụ hỗ trợ, rồi ứng dụng lo phần còn lại. Hãy dành vài phút: lần khởi động đầu tiên sẽ tải những gì nó cần để chạy.
macOS
macOS 10.15 trở lên. Apple Silicon (M1 trở lên) hoặc Intel.
Những gì bạn cần trước
Đánh dấu những gì bạn đã có; các bước bên dưới sẽ thay đổi theo.
Docker Desktop Bắt buộc
Nó chạy cơ sở dữ liệu và công cụ tìm kiếm mà ứng dụng cần. Ứng dụng sẽ khởi động chúng cho bạn.
Claude Code Cho chat
Cần cho trợ lý chat, và phần thiết lập sẽ chờ nó. Ứng dụng có thể cài nó giúp bạn trong phần Chat AI của thiết lập. Bản thân AI không do Project Orchestrator cung cấp.
Bước 1: Cài và khởi động Docker Desktop
Tải Docker Desktop từ trang của Docker, mở tệp, kéo Docker vào Applications, rồi mở nó và chờ đến khi nó báo đang chạy.
Bạn sẽ thấy. Docker Desktop đang mở và báo là đang chạy. Đây là màn hình của chính Docker nên không được tái hiện ở đây. Bước 2: Tải Project Orchestrator
Chọn tệp phù hợp với Mac của bạn. Không chắc là loại nào? Mở menu Apple, chọn “About This Mac”: chip tên M1, M2, M3 hoặc M4 nghĩa là Apple Silicon; bất cứ thứ gì nhắc đến Intel nghĩa là Intel.
- Tải về .dmg
macOS, Apple Silicon
M1 trở lên · 46 MB
- Tải về .dmg
macOS, Intel
Mac dùng chip Intel · 53 MB
Bạn sẽ thấy. Tệp .dmg xuất hiện trong Downloads của bạn. Bước 3: Mở ứng dụng
Mở tệp .dmg, kéo Project Orchestrator vào Applications, rồi mở nó từ đó. Nếu macOS báo không thể kiểm tra ứng dụng, chúng tôi chưa xác minh được cách bản dựng được ký: hãy cho phép nó trong System Settings, Privacy & Security, bằng “Open Anyway”.
Bạn sẽ thấy. Một màn hình khởi động liệt kê những gì ứng dụng kiểm tra. Ở lần mở đầu tiên, các dòng Docker ghi “Setup pending”. Bước 4: Thiết lập 1 trên 4: Infrastructure
Giữ nguyên “Docker (recommended)”. Ứng dụng sẽ tìm Docker Desktop. Khi nó hiện “Docker Desktop is running”, bấm Next. Nếu nó báo Docker bị thiếu hoặc chưa chạy, hãy dùng nút bên cạnh thông báo, rồi chờ: ứng dụng tự kiểm tra lại.
Các dịch vụ dùng các cổng cục bộ 7474, 7687, 7700 và 4222, còn bản thân ứng dụng dùng cổng 6600.
Bạn sẽ thấy. Một dòng màu xanh lá ghi “Docker Desktop is running” bên dưới hai thẻ, với “Docker (recommended)” đang được chọn. Bước 5: Thiết lập 2 trên 4: Authentication
Trên máy tính chỉ mình bạn dùng, giữ “No authentication” và bấm Next. Trên mạng dùng chung hoặc mạng công cộng, hãy chọn “Password” và đặt email cùng mật khẩu: khi không có đăng nhập, máy chủ của ứng dụng chấp nhận kết nối từ cả mạng của bạn.
Bạn sẽ thấy. Ba lựa chọn (No authentication, Password, OIDC / OAuth), lựa chọn đầu tiên đang được chọn. Bước 6: Thiết lập 3 trên 4: Chat AI
Nếu hiện “Claude Code CLI is required”, bấm “Install Claude Code CLI”. Sau đó để ứng dụng tải mô hình tìm kiếm khi nó đề nghị; dung lượng được hiển thị trên màn hình. Nút Next mở khi cả hai đã sẵn sàng.
Nếu bạn chưa đăng nhập vào Claude, xem “Nếu không hoạt động” bên dưới.
Bạn sẽ thấy. Claude Code CLI hiện dấu tích xanh lá khi đã cài (trước đó: “Claude Code CLI is required” và một nút cài đặt), và mô hình tìm kiếm được đánh dấu là sẵn sàng. Bước 7: Thiết lập 4 trên 4: Launch
Bấm “Generate Config & Save”. Khi “Configuration saved!” xuất hiện, bấm “Restart Application”. Một công tắc trên màn hình này quyết định ứng dụng có kiểm tra bản cập nhật khi khởi động hay không.
Bạn sẽ thấy. Một thông báo xanh lá “Configuration saved!” và một nút “Restart Application”. Bước 8: Chờ lần khởi động đầu tiên
Ở lần khởi động thứ hai này, ứng dụng tải ba image mà nó chạy trên đó, rồi khởi động chúng. Lần đầu có thể mất vài phút tùy đường truyền của bạn; các lần sau dùng lại image nên nhanh hơn. Khi mọi dòng đều xanh lá, cửa sổ chính sẽ mở.
Nếu một dòng ghi “Taking longer than expected”, hãy chờ. Nếu xuất hiện nút “Continue anyway”, xem “Nếu không hoạt động”.
Bạn sẽ thấy. Một danh sách kiểm tra (Docker Desktop, Neo4j, Meilisearch, NATS, Backend server) chuyển sang xanh lá từng dòng một.
Nếu không hoạt động
Ba vấn đề bạn dễ gặp nhất, kèm những gì ứng dụng hiển thị.
Docker chưa chạy
Bạn thấy gì. Ứng dụng báo “Docker Desktop is not running” hoặc “Docker Desktop is required”.
Cần làm gì.
- Mở Docker từ thư mục Applications (nút Open của ứng dụng cũng làm việc này). Chờ đến khi Docker báo đang chạy.
- Quay lại Project Orchestrator: nó kiểm tra lại sau mỗi vài giây, trong khoảng hai phút. Sau đó, hãy thoát và mở lại ứng dụng.
Một cổng đang được dùng
Bạn thấy gì. Neo4j hoặc Meilisearch vẫn ở trạng thái “Unhealthy”, hoặc ứng dụng báo không khởi động được các dịch vụ. Các dịch vụ cần các cổng cục bộ 7474, 7687, 7700 và 4222.
Cần làm gì.
- Đóng chương trình khác đang dùng cổng đó: một cơ sở dữ liệu khác, một máy chủ tìm kiếm khác, hoặc một bản Project Orchestrator cũ.
- Chỉ cổng của chính ứng dụng (mặc định 6600) mới đổi được, trên màn hình Infrastructure của phần thiết lập, “API Server Port”.
Chỉ khi bạn quen với terminal, lệnh này cho thấy chương trình nào đang dùng cổng:
lsof -i :7687Chat không kết nối được với Claude
Bạn thấy gì. Phần thiết lập báo “Claude Code CLI is required”, hoặc chat báo chưa đăng nhập Claude.
Cần làm gì.
- Trên màn hình Chat AI của phần thiết lập, bấm “Install Claude Code CLI” (hoặc “Retry Install”).
- Nếu sau đó chat yêu cầu đăng nhập, mở ứng dụng Terminal, gõ lệnh bên dưới, nhấn Enter và đăng nhập vào Claude.
Gõ lệnh này rồi nhấn Enter:
claudeWindows
Windows, 64 bit.
Những gì bạn cần trước
Đánh dấu những gì bạn đã có; các bước bên dưới sẽ thay đổi theo.
Docker Desktop Bắt buộc
Nó chạy cơ sở dữ liệu và công cụ tìm kiếm mà ứng dụng cần. Ứng dụng sẽ khởi động chúng cho bạn.
Claude Code Cho chat
Cần cho trợ lý chat, và phần thiết lập sẽ chờ nó. Ứng dụng có thể cài nó giúp bạn trong phần Chat AI của thiết lập. Bản thân AI không do Project Orchestrator cung cấp.
Bước 1: Cài và khởi động Docker Desktop
Tải Docker Desktop từ trang của Docker, chạy trình cài đặt, rồi mở Docker Desktop từ menu Start và chờ đến khi nó báo đang chạy.
Bạn sẽ thấy. Docker Desktop đang mở và báo là đang chạy. Đây là màn hình của chính Docker nên không được tái hiện ở đây. Bước 2: Tải Project Orchestrator
Lấy trình cài đặt (.exe). Tệp .msi dành cho các máy tính do bộ phận IT quản lý.
- Tải về .exe
Windows, trình cài đặt
64 bit, có trình hướng dẫn cài đặt · 61 MB
- Tải về .msi
Windows, MSI
64 bit, cho triển khai có quản lý · 80 MB
Bạn sẽ thấy. Tệp .exe xuất hiện trong Downloads của bạn. Bước 3: Mở ứng dụng
Chạy trình cài đặt và làm theo trình hướng dẫn, rồi mở Project Orchestrator từ menu Start. Windows có thể hiện “Windows protected your PC” vì cấu hình bản dựng chưa có chứng chỉ ký: chọn “More info”, rồi “Run anyway” nếu bạn tin bản tải về.
Bạn sẽ thấy. Một màn hình khởi động liệt kê những gì ứng dụng kiểm tra. Ở lần mở đầu tiên, các dòng Docker ghi “Setup pending”. Bước 4: Thiết lập 1 trên 4: Infrastructure
Giữ nguyên “Docker (recommended)”. Ứng dụng sẽ tìm Docker Desktop. Khi nó hiện “Docker Desktop is running”, bấm Next. Nếu nó báo Docker bị thiếu hoặc chưa chạy, hãy dùng nút bên cạnh thông báo, rồi chờ: ứng dụng tự kiểm tra lại.
Các dịch vụ dùng các cổng cục bộ 7474, 7687, 7700 và 4222, còn bản thân ứng dụng dùng cổng 6600.
Bạn sẽ thấy. Một dòng màu xanh lá ghi “Docker Desktop is running” bên dưới hai thẻ, với “Docker (recommended)” đang được chọn. Bước 5: Thiết lập 2 trên 4: Authentication
Trên máy tính chỉ mình bạn dùng, giữ “No authentication” và bấm Next. Trên mạng dùng chung hoặc mạng công cộng, hãy chọn “Password” và đặt email cùng mật khẩu: khi không có đăng nhập, máy chủ của ứng dụng chấp nhận kết nối từ cả mạng của bạn.
Bạn sẽ thấy. Ba lựa chọn (No authentication, Password, OIDC / OAuth), lựa chọn đầu tiên đang được chọn. Bước 6: Thiết lập 3 trên 4: Chat AI
Nếu hiện “Claude Code CLI is required”, bấm “Install Claude Code CLI”. Sau đó để ứng dụng tải mô hình tìm kiếm khi nó đề nghị; dung lượng được hiển thị trên màn hình. Nút Next mở khi cả hai đã sẵn sàng.
Nếu bạn chưa đăng nhập vào Claude, xem “Nếu không hoạt động” bên dưới.
Bạn sẽ thấy. Claude Code CLI hiện dấu tích xanh lá khi đã cài (trước đó: “Claude Code CLI is required” và một nút cài đặt), và mô hình tìm kiếm được đánh dấu là sẵn sàng. Bước 7: Thiết lập 4 trên 4: Launch
Bấm “Generate Config & Save”. Khi “Configuration saved!” xuất hiện, bấm “Restart Application”. Một công tắc trên màn hình này quyết định ứng dụng có kiểm tra bản cập nhật khi khởi động hay không.
Bạn sẽ thấy. Một thông báo xanh lá “Configuration saved!” và một nút “Restart Application”. Bước 8: Chờ lần khởi động đầu tiên
Ở lần khởi động thứ hai này, ứng dụng tải ba image mà nó chạy trên đó, rồi khởi động chúng. Lần đầu có thể mất vài phút tùy đường truyền của bạn; các lần sau dùng lại image nên nhanh hơn. Khi mọi dòng đều xanh lá, cửa sổ chính sẽ mở.
Nếu một dòng ghi “Taking longer than expected”, hãy chờ. Nếu xuất hiện nút “Continue anyway”, xem “Nếu không hoạt động”.
Bạn sẽ thấy. Một danh sách kiểm tra (Docker Desktop, Neo4j, Meilisearch, NATS, Backend server) chuyển sang xanh lá từng dòng một.
Nếu không hoạt động
Ba vấn đề bạn dễ gặp nhất, kèm những gì ứng dụng hiển thị.
Docker chưa chạy
Bạn thấy gì. Ứng dụng báo “Docker Desktop is not running” hoặc “Docker Desktop is required”.
Cần làm gì.
- Mở Docker Desktop từ menu Start (nút Open của ứng dụng cũng làm việc này). Chờ đến khi Docker báo đang chạy.
- Quay lại Project Orchestrator: nó kiểm tra lại sau mỗi vài giây, trong khoảng hai phút. Sau đó, hãy đóng và mở lại ứng dụng.
Một cổng đang được dùng
Bạn thấy gì. Neo4j hoặc Meilisearch vẫn ở trạng thái “Unhealthy”, hoặc ứng dụng báo không khởi động được các dịch vụ. Các dịch vụ cần các cổng cục bộ 7474, 7687, 7700 và 4222.
Cần làm gì.
- Đóng chương trình khác đang dùng cổng đó: một cơ sở dữ liệu khác, một máy chủ tìm kiếm khác, hoặc một bản Project Orchestrator cũ.
- Chỉ cổng của chính ứng dụng (mặc định 6600) mới đổi được, trên màn hình Infrastructure của phần thiết lập, “API Server Port”.
Chỉ khi bạn quen với terminal, lệnh này cho thấy chương trình nào đang dùng cổng:
netstat -ano | findstr :7687Chat không kết nối được với Claude
Bạn thấy gì. Phần thiết lập báo “Claude Code CLI is required”, hoặc chat báo chưa đăng nhập Claude.
Cần làm gì.
- Trên màn hình Chat AI của phần thiết lập, bấm “Install Claude Code CLI” (hoặc “Retry Install”).
- Nếu sau đó chat yêu cầu đăng nhập, mở PowerShell, gõ lệnh bên dưới, nhấn Enter và đăng nhập vào Claude.
Gõ lệnh này rồi nhấn Enter:
claudeLinux
AppImage cho Intel/AMD; các gói .deb và .rpm cho Intel/AMD và ARM64.
Những gì bạn cần trước
Đánh dấu những gì bạn đã có; các bước bên dưới sẽ thay đổi theo.
Docker Desktop Bắt buộc
Nó chạy cơ sở dữ liệu và công cụ tìm kiếm mà ứng dụng cần. Ứng dụng sẽ khởi động chúng cho bạn.
Claude Code Cho chat
Cần cho trợ lý chat, và phần thiết lập sẽ chờ nó. Ứng dụng có thể cài nó giúp bạn trong phần Chat AI của thiết lập. Bản thân AI không do Project Orchestrator cung cấp.
Bước 1: Cài và khởi động Docker Desktop
Làm theo trang của Docker cho bản phân phối của bạn, rồi khởi động Docker và chờ đến khi nó báo đang chạy. Ứng dụng cũng nhận ra Docker được cài mà không có ứng dụng Desktop.
Bạn sẽ thấy. Docker đang chạy. Đây là màn hình của chính Docker nên không được tái hiện ở đây. Bước 2: Tải Project Orchestrator
AppImage chạy trên mọi bản phân phối. Dùng tệp .deb trên Debian và Ubuntu, tệp .rpm trên Fedora và RHEL.
- Tải về .AppImage
Linux, AppImage
x86_64, chạy trên mọi bản phân phối · 132 MB
Các phiên bản khác cho hệ điều hành này
- Tải về .deb
Debian và Ubuntu, x86_64
dpkg hoặc apt · 61 MB
- Tải về .deb
Debian và Ubuntu, arm64
dpkg hoặc apt, máy ARM64 · 55 MB
- Tải về .rpm
Fedora và RHEL, x86_64
dnf hoặc rpm · 38 MB
- Tải về .rpm
Fedora và RHEL, arm64
dnf hoặc rpm, máy ARM64 · 32 MB
Bạn sẽ thấy. Tệp xuất hiện trong Downloads của bạn. Bước 3: Mở ứng dụng
Với AppImage: trong trình quản lý tệp, mở thuộc tính của tệp và cho phép nó chạy như một chương trình, rồi nhấp đúp vào nó. Với tệp .deb hoặc .rpm: mở bằng trình cài đặt phần mềm của bạn, rồi mở Project Orchestrator từ menu ứng dụng.
Bạn sẽ thấy. Một màn hình khởi động liệt kê những gì ứng dụng kiểm tra. Ở lần mở đầu tiên, các dòng Docker ghi “Setup pending”. Bước 4: Thiết lập 1 trên 4: Infrastructure
Giữ nguyên “Docker (recommended)”. Ứng dụng sẽ tìm Docker Desktop. Khi nó hiện “Docker Desktop is running”, bấm Next. Nếu nó báo Docker bị thiếu hoặc chưa chạy, hãy dùng nút bên cạnh thông báo, rồi chờ: ứng dụng tự kiểm tra lại.
Các dịch vụ dùng các cổng cục bộ 7474, 7687, 7700 và 4222, còn bản thân ứng dụng dùng cổng 6600.
Bạn sẽ thấy. Một dòng màu xanh lá ghi “Docker Desktop is running” bên dưới hai thẻ, với “Docker (recommended)” đang được chọn. Bước 5: Thiết lập 2 trên 4: Authentication
Trên máy tính chỉ mình bạn dùng, giữ “No authentication” và bấm Next. Trên mạng dùng chung hoặc mạng công cộng, hãy chọn “Password” và đặt email cùng mật khẩu: khi không có đăng nhập, máy chủ của ứng dụng chấp nhận kết nối từ cả mạng của bạn.
Bạn sẽ thấy. Ba lựa chọn (No authentication, Password, OIDC / OAuth), lựa chọn đầu tiên đang được chọn. Bước 6: Thiết lập 3 trên 4: Chat AI
Nếu hiện “Claude Code CLI is required”, bấm “Install Claude Code CLI”. Sau đó để ứng dụng tải mô hình tìm kiếm khi nó đề nghị; dung lượng được hiển thị trên màn hình. Nút Next mở khi cả hai đã sẵn sàng.
Nếu bạn chưa đăng nhập vào Claude, xem “Nếu không hoạt động” bên dưới.
Bạn sẽ thấy. Claude Code CLI hiện dấu tích xanh lá khi đã cài (trước đó: “Claude Code CLI is required” và một nút cài đặt), và mô hình tìm kiếm được đánh dấu là sẵn sàng. Bước 7: Thiết lập 4 trên 4: Launch
Bấm “Generate Config & Save”. Khi “Configuration saved!” xuất hiện, bấm “Restart Application”. Một công tắc trên màn hình này quyết định ứng dụng có kiểm tra bản cập nhật khi khởi động hay không.
Bạn sẽ thấy. Một thông báo xanh lá “Configuration saved!” và một nút “Restart Application”. Bước 8: Chờ lần khởi động đầu tiên
Ở lần khởi động thứ hai này, ứng dụng tải ba image mà nó chạy trên đó, rồi khởi động chúng. Lần đầu có thể mất vài phút tùy đường truyền của bạn; các lần sau dùng lại image nên nhanh hơn. Khi mọi dòng đều xanh lá, cửa sổ chính sẽ mở.
Nếu một dòng ghi “Taking longer than expected”, hãy chờ. Nếu xuất hiện nút “Continue anyway”, xem “Nếu không hoạt động”.
Bạn sẽ thấy. Một danh sách kiểm tra (Docker Desktop, Neo4j, Meilisearch, NATS, Backend server) chuyển sang xanh lá từng dòng một.
Nếu không hoạt động
Ba vấn đề bạn dễ gặp nhất, kèm những gì ứng dụng hiển thị.
Docker chưa chạy
Bạn thấy gì. Ứng dụng báo “Docker Desktop is not running” hoặc “Docker Desktop is required”.
Cần làm gì.
- Khởi động Docker Desktop, hoặc dịch vụ Docker của bạn nếu bạn dùng Docker mà không có ứng dụng Desktop. Nút Open của ứng dụng chỉ thử khởi động Docker Desktop.
- Quay lại Project Orchestrator: nó kiểm tra lại sau mỗi vài giây, trong khoảng hai phút. Sau đó, hãy đóng và mở lại ứng dụng.
Một cổng đang được dùng
Bạn thấy gì. Neo4j hoặc Meilisearch vẫn ở trạng thái “Unhealthy”, hoặc ứng dụng báo không khởi động được các dịch vụ. Các dịch vụ cần các cổng cục bộ 7474, 7687, 7700 và 4222.
Cần làm gì.
- Đóng chương trình khác đang dùng cổng đó: một cơ sở dữ liệu khác, một máy chủ tìm kiếm khác, hoặc một bản Project Orchestrator cũ.
- Chỉ cổng của chính ứng dụng (mặc định 6600) mới đổi được, trên màn hình Infrastructure của phần thiết lập, “API Server Port”.
Chỉ khi bạn quen với terminal, lệnh này cho thấy chương trình nào đang dùng cổng:
lsof -i :7687Chat không kết nối được với Claude
Bạn thấy gì. Phần thiết lập báo “Claude Code CLI is required”, hoặc chat báo chưa đăng nhập Claude.
Cần làm gì.
- Trên màn hình Chat AI của phần thiết lập, bấm “Install Claude Code CLI” (hoặc “Retry Install”).
- Nếu sau đó chat yêu cầu đăng nhập, mở một terminal, gõ lệnh bên dưới, nhấn Enter và đăng nhập vào Claude.
Gõ lệnh này rồi nhấn Enter:
claudeCâu hỏi
Trước khi cài đặt
Các câu trả lời ngắn, mỗi câu đều được đối chiếu với mã nguồn của ứng dụng.
Có miễn phí không?
Có. Bản tải về không mất phí và mã nguồn được công khai trên GitHub.
Khoản chi phí duy nhất có thể phát sinh nằm ngoài ứng dụng: trợ lý chat chạy qua Claude Code, thứ bạn cài riêng và tuân theo các gói cùng điều khoản của Anthropic.
Dữ liệu của tôi đi đâu?
Kế hoạch, tác vụ, ghi chú và quyết định của bạn nằm trên máy tính của bạn, trong một cơ sở dữ liệu và một công cụ tìm kiếm do ứng dụng khởi động cho bạn. Chúng chỉ nhận kết nối từ chính máy của bạn.
Chat là phần duy nhất giao tiếp với bên ngoài: những gì bạn gõ, và những gì trợ lý đọc để trả lời bạn, được Claude Code gửi đến Claude, theo điều khoản của Anthropic.
Tìm kiếm theo ý nghĩa chạy trên máy tính của bạn (mô hình của nó chỉ được tải một lần). Ứng dụng kiểm tra GitHub xem có phiên bản mới không khi khởi động. Không tìm thấy mã phân tích hay theo dõi nào trong mã nguồn.
Tôi có cần tài khoản không?
Không cần tài khoản Project Orchestrator: không có gì để đăng ký, và theo mặc định phần thiết lập không dùng đăng nhập.
Bạn có thể thêm mật khẩu, hoặc đăng nhập bằng Google, Microsoft hay một nhà cung cấp OpenID khác, trong lúc thiết lập.
Cần biết: khi không có đăng nhập, máy chủ riêng của ứng dụng chấp nhận kết nối từ cả mạng của bạn, không chỉ từ máy tính của bạn. Trên mạng dùng chung, hãy chọn mật khẩu.
Tôi có phải cài Docker không?
Có, theo mặc định. Ứng dụng giữ dữ liệu của bạn trong một cơ sở dữ liệu và một công cụ tìm kiếm, và chạy chúng bằng Docker Desktop. Bạn cài Docker Desktop một lần; sau đó ứng dụng tự khởi động và dừng các dịch vụ đó.
Phần thiết lập kiểm tra Docker, cho bạn biết nếu nó thiếu hoặc chưa chạy, và không cho bạn tiếp tục cho đến khi nó chạy.
Những ai đã có sẵn máy chủ cơ sở dữ liệu và tìm kiếm riêng có thể trỏ ứng dụng đến chúng (lựa chọn “External servers” trong phần thiết lập).
AI có đi kèm không, hay tôi cần gói đăng ký hoặc khóa riêng?
AI không đi kèm. Trợ lý chat hoạt động qua Claude Code, công cụ của Anthropic, phải có trên máy tính của bạn và đã đăng nhập vào tài khoản Claude của bạn. Phần thiết lập có thể cài nó giúp bạn.
Để đăng nhập, bạn có thể phải gõ claude một lần trong terminal; thông báo của chính ứng dụng sẽ nói như vậy. Phần thiết lập không yêu cầu khóa nào.
Gói nào mà Claude Code yêu cầu là do Anthropic quyết định, nên hãy xem trang của họ. Phần thiết lập sẽ không cho bạn hoàn tất cho đến khi phát hiện được Claude Code.
Tôi có thể dùng mà không cần viết mã không?
Với việc dùng hằng ngày thì có: bạn làm việc trong ứng dụng (Today, kế hoạch, tác vụ, ghi chú, quyết định) và nhờ trợ lý trong một cuộc chat. Việc cài đặt cũng không cần terminal, ngoại trừ lần đăng nhập Claude một lần có thể phải làm.
Một dự án không nhất thiết là phần mềm: các phiên bản gần đây hỗ trợ dự án không có thư mục mã.
Giới hạn cần nói thật: sản phẩm bắt đầu từ các nhà phát triển, và một số màn hình vẫn nghiêng về phía đó, ví dụ các gợi ý khởi đầu của chat (phân tích tác động, tìm kiếm mã, kiến trúc).
Nó chạy trên những máy tính nào?
macOS 10.15 trở lên (Apple Silicon và Intel), Windows 64 bit, và Linux (một AppImage cho máy Intel/AMD, các gói .deb và .rpm cho Intel/AMD và ARM64).
Docker Desktop phải chạy trên cùng máy tính. Không có ứng dụng điện thoại và không có phiên bản web được lưu trữ sẵn: các bản tải về ở trang phát hành đều là gói cho máy tính.
Làm sao để cập nhật?
Ứng dụng máy tính kiểm tra phiên bản mới mỗi lần khởi động và hiện một biểu ngữ khi đã có. Bạn có thể tắt việc này ở bước cuối của phần thiết lập.
Nếu không thấy biểu ngữ, hãy tải trình cài đặt mới nhất từ trang phát hành và chạy nó.
Tôi có thể dùng cùng nhóm của mình không?
Chưa như một không gian chung cho nhóm: hiện mỗi người chạy Project Orchestrator của riêng mình.
Những gì đã có: không gian làm việc, để gom nhiều dự án của bạn, và một phiên bản đầu của việc chia sẻ giữa hai phiên bản. Bạn quyết định, theo từng dự án, ghi chú được chia sẻ thủ công, được gợi ý cho bạn, hay được gửi tự động; bản sao có thể hết hạn, và bạn có thể rút lại một lần chia sẻ.
Những gì nằm trong dự kiến và chưa có: một kho tri thức chung cho cả công ty, nhóm và phân cấp, vai trò và quyền truy cập.
Giấy phép của nó là gì?
Hai giấy phép, như tệp LICENSE nêu (bản quyền FFS SAS): MIT AND BUSL-1.1.
Các phần theo giấy phép MIT có thể được dùng, sao chép, sửa đổi và chia sẻ tự do.
Phần được đánh dấu Enterprise Edition theo Business Source License 1.1: bạn có thể thử nghiệm, phát triển và đánh giá với nó, nhưng dùng nó trong môi trường production cần giấy phép thương mại từ FFS SAS (contact@ffs.holdings). Phần đó trở thành MIT bốn năm sau khi được công bố.
Chuyện gì xảy ra khi tôi đóng cửa sổ?
Đóng cửa sổ sẽ ẩn ứng dụng xuống khay hệ thống; nó vẫn tiếp tục chạy. Chọn Quit từ biểu tượng trên khay để dừng nó.
Thoát cũng dừng ba dịch vụ mà ứng dụng đã khởi động trong Docker (cơ sở dữ liệu, tìm kiếm, sự kiện). Nếu bạn dùng máy chủ của riêng mình, nó để yên chúng.
Làm sao để nhận trợ giúp hoặc đóng góp?
Tham gia Discord để nhờ giúp đỡ hoặc góp ý. Với một lỗi, hãy mở một issue trên GitHub kèm hệ điều hành của bạn, các bước để tái hiện và mọi thông báo lỗi.
Chúng tôi hoan nghênh đóng góp. Hướng dẫn đóng góp giải thích cách thiết lập dự án và một báo cáo tốt gồm những gì; nó được viết cho các nhà phát triển.
Bắt đầu
Cho các trợ lý AI của bạn một bộ nhớ và một kế hoạch
Cài trình điều phối, kết nối Claude Code qua MCP, rồi để trợ lý đầu tiên đọc dự án trước khi viết dòng mã đầu tiên.
Hoặc bắt đầu từ terminal
brew install this-rs/tap/project-orchestrator