Bắt đầu

Bestie là AI companion local-first. Sau khi cài, Sếp dùng lệnh bestie để setup, kiểm tra, chat và bật các channel như Telegram.

Yêu cầu

• Node.js và npm.
• Source Bestie hoặc bản cài local.
• Một provider LLM tương thích OpenAI API.
• API key lưu trong .bestie/.env, không lưu trực tiếp trong config.json.
• Tùy chọn: Telegram bot token nếu muốn dùng Telegram.

Cài từ source checkout

./install.sh --skip-onboard
bestie onboard
bestie doctor

Installer mặc định dùng ~/.local/share/bestie/source và expose lệnh bestie từ ~/.local/bin. Reinstall sẽ giữ .bestie/ và từ chối ghi đè thư mục lạ.

Lệnh thường dùng

bestie --help
bestie onboard
bestie onboard --skip-provider-test
bestie chat
bestie status
bestie logs
bestie doctor
bestie doctor --json
bestie doctor --fix

Trong terminal chat:

/help
/status
/memory
/memory pause
/memory resume
/pending

Kiểm tra setup

Sau onboarding, chạy:

bestie doctor
bestie status

Doctor sẽ kiểm tra config, env, provider, memory, logs, Telegram và các điều kiện local quan trọng mà không in secrets.

Lỗi provider thường gặp

• Provider request timed out: endpoint quá chậm. Thử lại, đổi model nhanh hơn hoặc tăng llm.timeoutMs.
• Could not reach the provider endpoint: kiểm tra llm.baseUrl, DNS, network, VPN/proxy và trạng thái provider.
• Provider authentication failed: kiểm tra API key trong .bestie/.env và llm.apiKeyEnv.
• Provider rate limit reached: đợi hoặc kiểm tra quota/billing.
• Provider returned an unusable response: model có thể không hỗ trợ OpenAI-compatible chat completions.