Kimi K2.5 GitHub ekosistemi, geliştiriciler Moonshot AI'nin amiral gemisi modelinin etrafında araçlar, entegrasyonlar ve uygulamalar geliştirdikçe hızla büyüyor. Bu kapsamlı rehber, Kimi K2.5 geliştirmenizi hızlandırmak için resmi repoları, topluluk projelerini, SDK'ları ve kaynakları ele alıyor.
Resmi Kimi K2.5 GitHub Kaynakları
Moonshot AI Resmi Repoları
| Repo | Açıklama | URL |
|---|---|---|
| kimi-cli | Resmi Kimi Code CLI | github.com/MoonshotAI/kimi-cli |
| Kimi-K2.5 | Model ağırlıkları & dokümanlar | huggingface.co/moonshotai/Kimi-K2.5 |
| MoonshotAI-Cookbook | Resmi API örnekleri | github.com/MoonshotAI/MoonshotAI-Cookbook |
Kimi Code CLI Reposu
Kimi Code CLI, Moonshot AI'nin terminal tabanlı resmi kodlama ajanıdır:
# Repoyu klonla
git clone https://github.com/MoonshotAI/kimi-cli.git
# Kaynaktan kur
cd kimi-cli
pip install -e .
Temel Özellikler:
- Terminal tabanlı yapay zeka kodlama asistanı
- ACP (Agent Client Protocol) desteği
- MCP (Model Context Protocol) entegrasyonu
- Çoklu sağlayıcı desteği
Repo Yapısı:
kimi-cli/
├── kimi/ # Ana paket
├── docs/ # Dokümantasyon
├── tests/ # Test paketi
├── examples/ # Kullanım örnekleri
└── README.md # Başlangıç rehberi
Kimi K2.5 Topluluk Projeleri
Takip Edilecek Herkese Açık Repolar
Aşağıdaki repolar şu anda doğrulanabilir ve aktiftir:
1. zsh-kimi-cli
- Kimi Code CLI için resmi Zsh eklentisi
- URL: github.com/MoonshotAI/zsh-kimi-cli
2. kimi-code-zed-extension
- Zed editörü için Kimi Code eklentisi
- URL: github.com/MoonshotAI/kimi-code-zed-extension
3. kimi-agent-sdk
- Moonshot AI'den Agent SDK kaynakları
- URL: github.com/MoonshotAI/kimi-agent-sdk
4. kimi-agent-rs
- Kimi ajan araçları için Rust ekosistemi reposu
- URL: github.com/MoonshotAI/kimi-agent-rs
Başlangıç Şablonları
Kimi K2.5 için listelenmiş tek bir resmi başlangıç şablonu reposu yoktur. Güvenli bir yaklaşım, önce uygulamanızın iskeletini oluşturmak, ardından OpenAI uyumlu bir istemci bağlamaktır.
Next.js + Kimi K2.5 Starter (manuel iskelet)
npx create-next-app@latest my-kimi-app
cd my-kimi-app
npm install openai
Python FastAPI + Kimi K2.5 Starter (manuel iskelet)
mkdir kimi-fastapi-starter && cd kimi-fastapi-starter
python -m venv .venv && source .venv/bin/activate
pip install fastapi uvicorn openai
Kimi K2.5 SDK'ları ve Kütüphaneleri
Python (OpenAI Uyumlu SDK)
pip install openai
from openai import OpenAI
client = OpenAI(
api_key="your-api-key",
base_url="https://api.moonshot.cn/v1"
)
# Basit tamamlama
response = client.chat.completions.create(
model="kimi-k2-5",
messages=[{"role": "user", "content": "Hello!"}]
)
# Akış (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 (OpenAI Uyumlu SDK)
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 (HTTP üzerinden OpenAI Uyumlu)
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))
}
Entegrasyon Örnekleri
OpenAI SDK Uyumlu
import openai
# Doğrudan yerine geçen (drop-in)
client = openai.OpenAI(
api_key="your-kimi-api-key",
base_url="https://api.moonshot.cn/v1"
)
# Mevcut OpenAI koduyla çalışır
response = client.chat.completions.create(
model="kimi-k2-5",
messages=[{"role": "user", "content": "Hello"}]
)
LangChain Entegrasyonu
from langchain_openai import ChatOpenAI
# LangChain ile kullan
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?")
LlamaIndex Entegrasyonu
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 ve Dağıtım
Docker Compose Kurulumu
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
Kubernetes Manifesti
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
Otomatik Test
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/
Model Dağıtım Pipeline'ı
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
Topluluk Katkıları
Katkı Yönergeleri
Kimi K2.5 projelerine katkıda bulunurken:
- Repoyu fork edin
- Bir özellik dalı oluşturun:
git checkout -b feature/amazing-feature - Değişiklikleri commit edin:
git commit -m 'Add amazing feature' - Dala push edin:
git push origin feature/amazing-feature - Bir Pull Request açın
Popüler Katkı Alanları
| Alan | Açıklama | Gereken Beceriler |
|---|---|---|
| SDK Geliştirme | Dil bağlamaları | Python, JS, Go, Rust |
| Entegrasyonlar | Framework eklentileri | Framework API'leri |
| Dokümantasyon | Eğitimler, rehberler | Teknik yazım |
| Örnekler | Demo uygulamalar | Full-stack geliştirme |
| Test | Hata raporları, QA | Test metodolojileri |
Kod Örnekleri Reposu
Eksiksiz Proje Örnekleri
# Resmi cookbook'u klonla
git clone https://github.com/MoonshotAI/MoonshotAI-Cookbook.git
cd MoonshotAI-Cookbook
# Dil/framework örneklerine göz at
find examples -maxdepth 2 -type f | head
Örnekleri Çalıştırma
# Bir örnek klasörü seçin ve README'sine göre çalıştırın
cd examples
ls
Sorun Takibi ve Destek
GitHub Issues
Sorunları resmi repolarda bildirin:
- Hatalar: Yeniden üretme adımlarını, ortam ayrıntılarını ekleyin
- Özellikler: Kullanım senaryosunu ve beklenen davranışı açıklayın
- Dokümantasyon: Belirsiz bölümleri işaret edin
Topluluk Desteği
- GitHub Discussions: Soru-cevap ve özellik istekleri
- Discord: Gerçek zamanlı topluluk desteği
- Stack Overflow: Soruları
kimi-k2-5etiketiyle sorun
SSS
Resmi Kimi K2.5 kod örneklerini nerede bulabilirim?
MoonshotAI-Cookbook reposunu ve kimi-cli içindeki examples dizinini kullanın.
Kimi K2.5 açık kaynak mı?
Kimi Code CLI açık kaynaktır (Apache 2.0). Model ağırlıkları, bazı ticari kısıtlamalarla birlikte Modified MIT License altında kullanılabilir.
Kimi K2.5 projelerine nasıl katkıda bulunurum?
İlgili repoyu fork edin, değişikliklerinizi yapın ve bir pull request gönderin. Belirli yönergeler için her reponun CONTRIBUTING.md dosyasını inceleyin.
Kimi K2.5 için başlangıç şablonları var mı?
Evet, Next.js, FastAPI, Django ve diğer framework'ler için topluluk şablonları mevcut. GitHub'da "kimi-k2-5 starter" veya "kimi-k2-5 template" araması yapın.
GitHub kaynaklarını kullanarak Kimi K2.5'i kendim barındırabilir miyim?
Evet, Docker ve Kubernetes için dağıtım yapılandırmaları topluluk repolarında ve resmi dokümantasyonda mevcut.