Ekosistem Kimi K2.5 GitHub berkembang pesat seiring para developer membangun tools, integrasi, dan aplikasi di sekitar model unggulan dari Moonshot AI. Panduan lengkap ini membahas repositori resmi, proyek komunitas, SDK, dan sumber daya untuk mempercepat pengembangan Kimi K2.5 Anda.
Sumber Daya GitHub Kimi K2.5 Resmi
Repositori Resmi Moonshot AI
| Repositori | Deskripsi | URL |
|---|---|---|
| kimi-cli | Kimi Code CLI resmi | github.com/MoonshotAI/kimi-cli |
| Kimi-K2.5 | Bobot model & dokumen | huggingface.co/moonshotai/Kimi-K2.5 |
| MoonshotAI-Cookbook | Contoh API resmi | github.com/MoonshotAI/MoonshotAI-Cookbook |
Repositori Kimi Code CLI
Kimi Code CLI adalah agen pemrograman berbasis terminal resmi dari Moonshot AI:
# Kloning repositori
git clone https://github.com/MoonshotAI/kimi-cli.git
# Instal dari kode sumber
cd kimi-cli
pip install -e .
Fitur Utama:
- Asisten pemrograman AI berbasis terminal
- Dukungan ACP (Agent Client Protocol)
- Integrasi MCP (Model Context Protocol)
- Dukungan multi-provider
Struktur Repositori:
kimi-cli/
├── kimi/ # Paket utama
├── docs/ # Dokumentasi
├── tests/ # Rangkaian pengujian
├── examples/ # Contoh penggunaan
└── README.md # Panduan memulai
Proyek Komunitas Kimi K2.5
Repositori Publik yang Patut Diperhatikan
Repositori berikut saat ini dapat diverifikasi dan aktif:
1. zsh-kimi-cli
- Plugin Zsh resmi untuk Kimi Code CLI
- URL: github.com/MoonshotAI/zsh-kimi-cli
2. kimi-code-zed-extension
- Ekstensi Kimi Code untuk editor Zed
- URL: github.com/MoonshotAI/kimi-code-zed-extension
3. kimi-agent-sdk
- Sumber daya Agent SDK dari Moonshot AI
- URL: github.com/MoonshotAI/kimi-agent-sdk
4. kimi-agent-rs
- Repositori ekosistem Rust untuk tooling agen Kimi
- URL: github.com/MoonshotAI/kimi-agent-rs
Template Awal
Tidak ada satu pun repo template-awal resmi yang terdaftar untuk Kimi K2.5. Pendekatan yang aman adalah membuat kerangka aplikasi Anda terlebih dahulu, lalu menghubungkan klien yang kompatibel dengan OpenAI.
Next.js + Kimi K2.5 Starter (scaffold manual)
npx create-next-app@latest my-kimi-app
cd my-kimi-app
npm install openai
Python FastAPI + Kimi K2.5 Starter (scaffold manual)
mkdir kimi-fastapi-starter && cd kimi-fastapi-starter
python -m venv .venv && source .venv/bin/activate
pip install fastapi uvicorn openai
SDK dan Library Kimi K2.5
Python (SDK Kompatibel OpenAI)
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.moonshot.cn/v1"
)
# Penyelesaian sederhana
response = client.chat.completions.create(
model="kimi-k2-5",
messages=[{"role": "user", "content": "Hello!"}]
)
# Streaming
for chunk in client.chat.completions.create(
model="kimi-k2-5",
messages=[{"role": "user", "content": "Tell me a story"}],
stream=True
):
print(chunk.choices[0].delta.content, end="")
JavaScript/TypeScript (SDK Kompatibel OpenAI)
npm install openai
import OpenAI from 'openai';
const client = new OpenAI({
apiKey: 'your-api-key',
baseURL: 'https://api.moonshot.cn/v1',
});
const response = await client.chat.completions.create({
model: 'kimi-k2-5',
messages: [{ role: 'user', content: 'Explain TypeScript' }],
});
Go (Kompatibel OpenAI via HTTP)
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
payload := []byte(`{
"model":"kimi-k2-5",
"messages":[{"role":"user","content":"Hello!"}]
}`)
req, _ := http.NewRequest("POST", "https://api.moonshot.cn/v1/chat/completions", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}
Contoh Integrasi
Kompatibel dengan OpenAI SDK
import openai
# Pengganti langsung (drop-in)
client = openai.OpenAI(
api_key="your-kimi-api-key",
base_url="https://api.moonshot.cn/v1"
)
# Berfungsi dengan kode OpenAI yang sudah ada
response = client.chat.completions.create(
model="kimi-k2-5",
messages=[{"role": "user", "content": "Hello"}]
)
Integrasi LangChain
from langchain_openai import ChatOpenAI
# Gunakan dengan LangChain
llm = ChatOpenAI(
model="kimi-k2-5",
openai_api_key="your-kimi-api-key",
openai_api_base="https://api.moonshot.cn/v1"
)
from langchain import LLMChain, PromptTemplate
template = """Answer the following question:
Question: {question}
Answer: """
prompt = PromptTemplate(template=template, input_variables=["question"])
chain = LLMChain(llm=llm, prompt=prompt)
response = chain.run("What is machine learning?")
Integrasi LlamaIndex
from llama_index.llms.openai import OpenAI
from llama_index.core import Settings
Settings.llm = OpenAI(
model="kimi-k2-5",
api_key="your-kimi-api-key",
api_base="https://api.moonshot.cn/v1"
)
from llama_index.core import VectorStoreIndex, SimpleDirectoryReader
documents = SimpleDirectoryReader("data").load_data()
index = VectorStoreIndex.from_documents(documents)
query_engine = index.as_query_engine()
response = query_engine.query("Summarize the documents")
Docker dan Deployment
Konfigurasi Docker Compose
version: '3.8'
services:
kimi-api:
image: vllm/vllm-openai:latest
command: >
--model moonshotai/Kimi-K2.5
--tensor-parallel-size 4
ports:
- '8000:8000'
deploy:
resources:
reservations:
devices:
- driver: nvidia
count: 4
capabilities: [gpu]
kimi-web:
build: ./web
ports:
- '3000:3000'
environment:
- KIMI_API_URL=http://kimi-api:8000
Manifest Kubernetes
apiVersion: v1
kind: ConfigMap
metadata:
name: kimi-config
data:
MODEL_NAME: 'moonshotai/Kimi-K2.5'
TENSOR_PARALLEL: '4'
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: kimi-deployment
spec:
replicas: 1
selector:
matchLabels:
app: kimi
template:
metadata:
labels:
app: kimi
spec:
containers:
- name: vllm
image: vllm/vllm-openai:latest
envFrom:
- configMapRef:
name: kimi-config
resources:
limits:
nvidia.com/gpu: '4'
GitHub Actions CI/CD
Pengujian Otomatis
name: Kimi K2.5 Tests
on: [push, pull_request]
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Set up Python
uses: actions/setup-python@v4
with:
python-version: '3.11'
- name: Install dependencies
run: |
pip install -r requirements.txt
pip install pytest
- name: Run tests
env:
KIMI_API_KEY: ${{ secrets.KIMI_API_KEY }}
run: pytest tests/
Pipeline Deployment Model
name: Deploy Kimi K2.5
on:
push:
branches: [main]
jobs:
deploy:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Deploy to Kubernetes
run: |
kubectl apply -f k8s/
kubectl rollout status deployment/kimi-deployment
Kontribusi Komunitas
Panduan Kontribusi
Saat berkontribusi pada proyek Kimi K2.5:
- Fork repositori
- Buat branch fitur:
git checkout -b feature/amazing-feature - Commit perubahan:
git commit -m 'Add amazing feature' - Push ke branch:
git push origin feature/amazing-feature - Buka Pull Request
Area Kontribusi Populer
| Area | Deskripsi | Keahlian Dibutuhkan |
|---|---|---|
| Pengembangan SDK | Language binding | Python, JS, Go, Rust |
| Integrasi | Plugin framework | API framework |
| Dokumentasi | Tutorial, panduan | Penulisan teknis |
| Contoh | Aplikasi demo | Pengembangan full-stack |
| Pengujian | Laporan bug, QA | Metodologi pengujian |
Repositori Contoh Kode
Contoh Proyek Lengkap
# Kloning cookbook resmi
git clone https://github.com/MoonshotAI/MoonshotAI-Cookbook.git
cd MoonshotAI-Cookbook
# Telusuri contoh per bahasa/framework
find examples -maxdepth 2 -type f | head
Menjalankan Contoh
# Pilih folder contoh lalu jalankan sesuai README-nya
cd examples
ls
Pelacakan Isu dan Dukungan
GitHub Issues
Laporkan isu di repositori resmi:
- Bug: Sertakan langkah reproduksi, detail lingkungan
- Fitur: Jelaskan kasus penggunaan dan perilaku yang diharapkan
- Dokumentasi: Tunjukkan bagian yang tidak jelas
Dukungan Komunitas
- GitHub Discussions: Tanya jawab dan permintaan fitur
- Discord: Dukungan komunitas waktu nyata
- Stack Overflow: Beri tag pertanyaan dengan
kimi-k2-5
FAQ
Di mana saya bisa menemukan contoh kode Kimi K2.5 resmi?
Gunakan MoonshotAI-Cookbook dan direktori examples di kimi-cli.
Apakah Kimi K2.5 open source?
Kimi Code CLI bersifat open source (Apache 2.0). Bobot model tersedia di bawah Modified MIT License dengan beberapa pembatasan komersial.
Bagaimana cara berkontribusi pada proyek Kimi K2.5?
Fork repositori terkait, buat perubahan Anda, lalu kirimkan pull request. Periksa CONTRIBUTING.md setiap repo untuk panduan spesifik.
Apakah ada template awal untuk Kimi K2.5?
Ya, template komunitas tersedia untuk Next.js, FastAPI, Django, dan framework lainnya. Cari di GitHub dengan "kimi-k2-5 starter" atau "kimi-k2-5 template".
Bisakah saya melakukan self-host Kimi K2.5 menggunakan sumber daya GitHub?
Ya, konfigurasi deployment untuk Docker dan Kubernetes tersedia di repositori komunitas dan dokumentasi resmi.