ข้ามไปเนื้อหา
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_KEYAPI key (สำหรับ cloud mode)cloud เท่านั้น
NARA_MODELโมเดลเริ่มต้น (default: nara-ai-7b)ไม่จำเป็น
NARA_DEVICEauto / cpu / cuda / mpsไม่จำเป็น
NARA_CACHE_DIRที่เก็บโมเดล (default: ~/.nara)ไม่จำเป็น
NARA_BASE_URLURL ของ self-hosted serverself-hosted
💡 Self-hosted vs Cloud

ถ้ารันโมเดลบนเครื่องเอง ไม่ต้องใส่ NARA_API_KEY — SDK จะโหลดโมเดล local อัตโนมัติ ถ้าใช้ cloud ให้ตั้ง NARA_API_KEY และ SDK จะเรียกผ่าน API