SDK
คู่มือ SDK
เลือกภาษาที่คุณใช้ — Python, TypeScript หรือ CLI
Python SDK
pip install nara-ai from nara import chat
# เริ่มต้น
model = chat.load("nara-ai-7b")
# คำสั่งเดียว
reply = model.ask("แปล 'Hello world' เป็นไทย")
# Streaming
for chunk in model.stream("เล่าเรื่องสั้น"):
print(chunk, end="")
# พูดคุยหลายรอบ (conversation)
conv = model.conversation(system_prompt="คุณเป็นพนักงานบริการลูกค้า")
conv.user("สินค้านี้รับประกันกี่ปี?")
print(conv.reply())
conv.user("และส่งฟรีไหม?")
print(conv.reply()) # จำบริบทรอบแรกได้อัตโนมัติ TypeScript SDK
npm install @naralab/ai import { Chat } from "@naralab/ai";
const model = new Chat({ model: "nara-ai-7b" });
// คำสั่งเดียว
const reply = await model.ask("แปล 'Hello world' เป็นไทย");
console.log(reply);
// Streaming
for await (const chunk of model.stream("เล่าเรื่องสั้น")) {
process.stdout.write(chunk);
}
// Conversation
const conv = model.conversation({
systemPrompt: "คุณเป็นพนักงานบริการลูกค้า"
});
await conv.user("สินค้านี้รับประกันกี่ปี?");
console.log(await conv.reply()); CLI
brew install naralab/tap/nara
# หรือ
npm install -g @naralab/cli คำสั่งทั้งหมด:
| คำสั่ง | คำอธิบาย |
|---|---|
nara chat | เข้าสู่ interactive chat mode |
nara ask "คำถาม" | ถามคำถามเดียว ได้คำตอบทันที |
nara load nara-ai-7b | ดาวน์โหลดโมเดลล่วงหน้า |
nara models | แสดงรายการโมเดลที่มี |
nara serve --port 8080 | รันเป็น REST API server |
nara finetune --data data.jsonl | เริ่ม fine-tuning |
# ตัวอย่าง: ถามคำถามเดียว
nara ask "เขียนอีเมลลากิจ 1 วัน"
# ตัวอย่าง: รันเป็น server
nara serve --port 8080 --model nara-ai-7b การตั้งค่า (Configuration)
ตั้งค่าผ่าน environment variables หรือไฟล์ .nara.env:
| ตัวแปร | คำอธิบาย | จำเป็นเมื่อ |
|---|---|---|
NARA_API_KEY | API key (สำหรับ cloud mode) | cloud เท่านั้น |
NARA_MODEL | โมเดลเริ่มต้น (default: nara-ai-7b) | ไม่จำเป็น |
NARA_DEVICE | auto / cpu / cuda / mps | ไม่จำเป็น |
NARA_CACHE_DIR | ที่เก็บโมเดล (default: ~/.nara) | ไม่จำเป็น |
NARA_BASE_URL | URL ของ self-hosted server | self-hosted |
💡 Self-hosted vs Cloud
ถ้ารันโมเดลบนเครื่องเอง ไม่ต้องใส่ NARA_API_KEY — SDK จะโหลดโมเดล local อัตโนมัติ ถ้าใช้ cloud ให้ตั้ง NARA_API_KEY และ SDK จะเรียกผ่าน API