Metadata-Version: 2.5
Name: locaith
Version: 1.2.0
Summary: Python SDK for Locaith-4-flash: web search, reasoning, 64K context and Bio-Memory.
Project-URL: Homepage, https://locaith.com
Author: Locaith
License: MIT
License-File: LICENSE
Keywords: ai,llm,locaith,openai-compatible,sdk,vietnamese
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: Vietnamese
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Typing :: Typed
Requires-Python: >=3.8
Requires-Dist: httpx<1,>=0.24
Description-Content-Type: text/markdown

# locaith

Python SDK cho **Locaith-4-flash**: tìm web, suy luận, ngữ cảnh 64K, Bio-Memory (kho nhớ riêng, bật sẵn).

```bash
pip install locaith
```

```python
from locaith import Locaith

client = Locaith(api_key="LocAI...")      # hoặc đặt biến môi trường LOCAITH_API_KEY

print(client.ask("Giá vàng SJC hôm nay?"))
print(client.ask("Tôi là kế toán trưởng công ty ABC."))
print(client.ask("Bạn nhớ tôi làm nghề gì?"))   # nhớ từ lần trước, kể cả sau khi tắt chương trình
```

Mỗi người dùng cuối một kho nhớ riêng:

```python
client = Locaith(api_key="LocAI...", user="khach_123")
```

Đầy đủ:

```python
r = client.chat.completions.create(
    messages=[{"role": "user", "content": "Giá vàng SJC hôm nay?"}],
)
print(r.choices[0].message.content, [s.url for s in r.sources], r.reasoning)

for text in client.chat.completions.create(messages="Viết bài về AI", stream=True).text():
    print(text, end="", flush=True)

client.chat.completions.create(messages="Câu hỏi riêng tư", memory=False)   # tắt nhớ cho một câu

client.memory.list()
client.memory.add("Quy ước báo cáo", "Đơn vị triệu đồng.", type="feedback")
client.memory.export("ky-uc.zip")
```

Async:

```python
from locaith import AsyncLocaith

async with AsyncLocaith() as client:
    print(await client.ask("Xin chào"))
```

Tương thích OpenAI: `base_url="https://memory-api.locaith.com/v1"`.

Trả lời nhanh (tắt suy luận, tự đặt truy vấn tìm web):

```python
client.ask("Giá vàng SJC hôm nay?", reasoning_effort="none", search_query="giá vàng SJC hôm nay")
```

Tạo file Word / Excel / PowerPoint / PDF / biểu đồ:

```python
r = client.chat.completions.create(messages="Xuất file Word hợp đồng dịch vụ tư vấn giữa Công ty ABC và Công ty Locaith, 120 triệu đồng")
print(r.text)
for f in r.files:
    client.files.download(f, "./tai-ve/")      # f.name, f.kind, f.size, f.url (hiệu lực 24 giờ)
```
