Rotayı planlayın
Duraklarınızı istediğiniz sırayla söyleyin; asistan şehirden şehre, patikadan patikaya yolculuğu bir araya getirsin.
PyPI’da · v0.2.0a4 beta
travel-animator bir MCP sunucusu içerir. Claude, Cursor veya MCP destekleyen başka bir asistana bağlayın ve yolculuğunuzu günlük dille anlatın. Yapay zekâ rotayı planlar, animasyonu ayarlar ve MP4’ü kendi bilgisayarınızda render eder.
pip install --pre "travel-animator[mcp]"Genel bakış
Travel Animator MCP sunucusu, Model Context Protocol üzerinden yapay zekâ asistanlarına rota videosu oluşturma sürecinin tamamını açan bir Python paketidir: PyPI’daki travel-animator. Paketi kurup bir kez oturum açın. Ardından Claude veya Cursor gibi bir asistan, yalnızca sohbette yazdıklarınıza dayanarak rota planlayabilir, animasyon stilini ayarlayabilir ve bilgisayarınızda MP4 render edebilir.
MCP, asistanları harici araçlara bağlayan açık bir standarttır. İstemciniz sunucuyu travel-animator mcp ile başlatır, kullanılabilir araçları keşfeder ve sohbet sırasında çağırır. Ayrı bir uygulama öğrenmeniz veya API anahtarları yapılandırmanız gerekmez; Travel Animator’da oturum açmanız yeterlidir.
Mobil uygulamayla aynı hesabı kullanarak aynı yolculukları oluşturur: Travel Animator’ın temelindeki animasyonlu rotalar, 3D araç modelleri ve harita stilleri. Videoları kendiniz hazırlamayı tercih ediyorsanız iOS ve Android uygulamaları terminal olmadan aynı olanakları sunar. Durak eklemek, araç seçmek ve dışa aktarmak telefonda dört adımlık bir işlemdir.
Asistanınız neler yapabilir?
MCP sunucusu sürecin tamamını araçlar olarak sunar. Böylece asistan, siz bir düzenleyici açmadan tek bir cümleden bitmiş bir video oluşturabilir.
Duraklarınızı istediğiniz sırayla söyleyin; asistan şehirden şehre, patikadan patikaya yolculuğu bir araya getirsin.
Animasyonun görünümünü ve hareketini — araç, rota stili ve tempo — günlük dille değişiklik isteyerek düzenleyin.
Kendi donanımınızda MP4 dışa aktarın. libx264 her platformda çalışır; NVIDIA kodlaması için h264_nvenc belirtin.
Kurulum
Bilgisayarınızda Python 3.12 veya üzeri kuruluysa yaklaşık iki dakika.
mcp ek bağımlılığıyla kurunBu ek, temel kurulumdan bilinçli olarak çıkarılan MCP SDK’yı yükler. Paket hâlâ beta aşamasında olduğundan ilk kararlı sürüme kadar --pre gerekir.
pip install --pre "travel-animator[mcp]"Mobil uygulamadaki hesabınızı kullanın. Etkileşimli terminalde giriş, sihirli bağlantı akışıyla yapılır: e-postanızı, ardından 6 haneli kodu girin. CI için bunun yerine bearer belirteci iletin. Kimlik bilgileri ~/.config/tada/credentials.json dosyasında 0600 izinleriyle saklanır.
travel-animator loginSunucuyu istemcinizin MCP yapılandırmasına ekleyip istemciyi yeniden başlatın. Ardından bir video isteyin. Asistan, yolculuğu oluşturmadan önce auth_status çağrısıyla oturum açtığınızı doğrulayabilir.
{
"mcpServers": {
"travel-animator-mcp": {
"command": "travel-animator",
"args": ["mcp"]
}
}
}Deneyin
Komut ezberlemenize gerek yok. Yolculuğu ve istediğiniz görünümü bir insana anlatır gibi tarif edin.
Komut satırı
travel-animator CLIMCP sunucusu, doğrudan kendiniz de kullanabileceğiniz küçük bir konsol betiğinin alt komutudur.
travel-animator loginSihirli bağlantıyla oturum açın veya etkileşimsiz kullanım için bearer belirteci kaydedin.
travel-animator logoutYerel olarak saklanan kimlik bilgilerini silin. Yalnızca bilgisayarınızda geçerlidir; sunucu tarafında oturum iptali henüz yoktur.
travel-animator render-bundleHazırlanmış bir paketi ağ erişimi olmadan MP4’e render edin. Tüm seçenekleri görmek için --help ile çalıştırın.
travel-animator mcpstdio MCP sunucusunu başlatın. mcp ek bağımlılığı gerekir.
Başlamadan önce
Render için bir OpenGL uygulaması gerekir: üretim ortamında GPU sürücüsü veya yalnızca CPU kullanan Linux’ta Mesa/llvmpipe. Ayrıca FFmpeg/PyAV’ın standart çalışma zamanı kitaplıkları da gereklidir.
Linux, macOS ve Windows desteklenir. Windows’ta GL bağlamını WGL oluşturur ve bunun için etkileşimli bir masaüstü oturumu gerekir. Bir hizmet bu bağlamı oluşturamaz; yazılımsal render yedeği de yoktur.
Bu, açık kaynak değil, sınırlı kullanım lisansıdır. Travel Animator içeriğini hazırlamak ve render etmek için paketi değiştirmeden kurup çalıştırabilirsiniz. Yeniden dağıtım, değişiklik ve rakip hizmetler yasaktır. Ek haklar için Lascade ile iletişime geçin.
Sık sorulan sorular
MCP, yapay zekâ asistanlarını harici araçlara ve verilere bağlayan açık bir standarttır. Claude Desktop, Claude Code veya Cursor gibi bir istemci MCP sunucusunu başlatır, sunduğu araçları keşfeder ve sohbet sırasında sizin adınıza çağırabilir. travel-animator böyle bir sunucu içerdiğinden asistan rota videosu oluşturma sürecini doğrudan yönetebilir.
stdio üzerinden MCP destekleyen tüm istemciler; Claude Desktop, Claude Code ve Cursor dâhil. Hepsi, mcp argümanıyla travel-animator komutunu gösteren aynı JSON yapılandırma bloğunu kullanır.
Evet. Paket, Travel Animator hizmetinin tamamlayıcısıdır; önce travel-animator login çalıştırın. Mobil uygulamayla aynı hesap sistemini kullanır. Oturum açılmamışsa kimlik bilgisi gerektiren araçlar durur ve giriş yapmanızı isteyen açık bir mesaj gösterir.
Kendi bilgisayarınızda. Render, yerel OpenGL uygulamanızı ve FFmpeg kitaplıklarını kullanır. render-bundle, hazırlanmış bir paketi hiçbir ağ erişimi olmadan render eder.
Paket hâlâ beta aşamasındadır ve pip varsayılan olarak ön sürümleri atlar. --pre seçeneğiyle kurun: pip install --pre "travel-animator[mcp]".
Hayır. travel-animator sınırlı kullanım lisansıyla yayımlanır. Travel Animator içeriğini hazırlamak ve render etmek için değiştirmeden kurup çalıştırabilirsiniz; ancak yeniden dağıtamaz, değiştiremez veya rakip hizmet oluşturmak için kullanamazsınız. Koşulların tamamı pakette bulunur. Birlikte gelen yazı tipleri ve bayrak görselleri kendi OFL ve MIT lisanslarına tabi olmaya devam eder.
Evet. Varsayılan kodlayıcı, her platformda çalışan libx264’tür. NVIDIA donanım kodlaması için render-bundle’a --encoder h264_nvenc iletin.
Projeler, rotalar ve render edilmiş videolar bilgisayarınıza kaydedilir; bir rotayı açıkça hesabınıza kaydetmediğiniz sürece asla yüklenmez. Analitik isteğe bağlıdır ve varsayılan olarak kapalıdır: travel-animator analytics on çalıştırılana kadar veri toplanmaz; travel-animator analytics off onayı geri çeker. Onayınızla kaydedilen olaylar, hangi araçların çalıştığını, sıralarını, sürelerini ve başarısız olup olmadıklarını, ayrıca render ayarlarını ve rotadaki nokta sayısını içerir. Koordinatlar, yer adları, dosya yolları, medyanız veya araçların döndürdüğü sonuçlar asla toplanmaz. Ayrıntılar https://www.travelanimator.com/privacy-policy adresindeki gizlilik politikasındadır.
Travel Animator öncelikle bir mobil uygulamadır. iOS ve Android’de aynı animasyonlu rotaları kendiniz oluşturun; terminal gerekmez.
Uygulamayı indirin