İçeriğe geç
ArmIn
app.header.homeapp.header.docs

Giriş

ArmIn kullanmaya başlayın.

ArmIn açık kaynaklı bir AI kodlama ajanıdır. Terminal tabanlı bir arayüz, masaüstü uygulaması veya IDE uzantısı olarak mevcuttur.

armin TUI with the armin theme

Başlayalım.

Ön koşullar

ArmIn’u terminalinizde kullanmak için ihtiyacınız olacak:

  1. Şu gibi modern bir terminal emülatörü:

  2. Kullanmak istediğiniz LLM sağlayıcılarının API anahtarları.

Kurulum

ArmIn’u kurmanın en kolay yolu kurulum betiğidir.

Terminal window
curl -fsSL https://armin.com.cn/install | bash

Ayrıca aşağıdaki komutlarla da yükleyebilirsiniz:

  • Node.js’yi kullanma

    Terminal window
    npm install -g armin-ai

  • Homebrew’u macOS ve Linux’ta kullanma

    Terminal window
    brew install anomalyco/tap/armin

    En güncel sürümler için ArmIn tap’ini kullanmanızı öneririz. Resmi brew install armin formülü Homebrew ekibi tarafından korunur ve daha sık güncellenir.

  • Paru’yu Arch Linux’ta kullanma

    Terminal window
    sudo pacman -S armin           # Arch Linux (Stable)
    paru -S armin-bin              # Arch Linux (Latest from AUR)

Windows

  • Chocolatey Kullanımı

    Terminal window
    choco install armin

  • Scoop Kullanımı

    Terminal window
    scoop install armin

  • NPM kullanarak

    Terminal window
    npm install -g armin-ai

  • Mise Kullanımı

    Terminal window
    mise use -g github:simon-cheung/arm-in

  • Docker’ı kullanma

    Terminal window
    docker run -it --rm ghcr.io/simon-cheung/arm-in

ArmIn’un Bun kullanılarak Windows’a yüklenmesine yönelik destek şu anda devam etmektedir.

İkili dosyayı Releases’dan da alabilirsiniz.

Yapılandırma

ArmIn ile herhangi bir LLM sağlayıcısının API anahtarlarını yapılandırarak kullanabilirsiniz.

LLM sağlayıcılarını kullanmaya yeni başlıyorsanız, ArmIn Zen kullanmanızı öneririz. ArmIn ekibi tarafından test edilmiş ve doğrulanmış modellerin seçilmiş bir listesidir.

  1. TUI’de /connect komutunu çalıştırın, ArmIn’u seçin ve armin.com.cn/auth’ye gidin.

    /connect

  2. Oturum açın, fatura ayrıntılarınızı ekleyin ve API anahtarınızı kopyalayın.

  3. API anahtarınızı yapıştırın.

    ┌ API key
    │
    │
    └ enter

Alternatif olarak diğer sağlayıcılardan birini seçebilirsiniz. Daha fazla bilgi.

Başlatma

Artık bir sağlayıcı yapılandırdığınıza göre, üzerinde çalışmak istediğiniz bir projeye gidebilirsiniz.

Terminal window
cd /path/to/project

Ve ArmIn’u çalıştırın.

Terminal window
armin

Daha sonra aşağıdaki komutu çalıştırarak proje için ArmIn’u başlatın.

/init

Bu, ArmIn’un projenizi analiz etmesini ve bir AGENTS.md proje kökünde dosyası oluşturmasını sağlayacaktır.

Bu, ArmIn’un proje yapısını ve kullanılan kodlama kalıplarını anlamasına yardımcı olur.

Kullanım

Artık projeniz üzerinde çalışmak için ArmIn’u kullanmaya hazırsınız. Dilediğiniz soruyu sorabilirsiniz.

AI kodlama ajanını kullanmaya yeniyseniz aşağıdaki örnekler yardımcı olabilir.

Soru Sorma

ArmIn’dan kod tabanını size açıklamasını isteyebilirsiniz.

How is authentication handled in @packages/functions/src/api/index.ts

Kod tabanının üzerinde çalışmadığınız bir kısmı varsa bu yararlı olur.

Özellik Ekleme

ArmIn’dan projenize yeni özellikler eklemesini isteyebilirsiniz. Yine de öncelikle ondan bir plan oluşturmasını istemenizi öneririz.

  1. Bir plan oluşturun

    ArmIn, değişiklik yapma özelliğini kapatan bir _Plan modu_\na sahiptir. Bu modda, özelliğin nasıl uygulanacağını önerir.

    Tab tuşunu kullanarak buna geçin. Bunun için sağ alt köşede bir gösterge göreceksiniz.

    <TAB>

    Şimdi ne yapmasını istediğimizi anlatalım.

    When a user deletes a note, we'd like to flag it as deleted in the database.
    Then create a screen that shows all the recently deleted notes.
    From this screen, the user can undelete a note or permanently delete it.

    ArmIn’un isteğinizi anlaması için yeterli ayrıntı verin. Ekibinizdeki junior bir geliştiriciyle konuşur gibi yazmak genelde iyi sonuç verir.

  2. Planı yineleyin

    Size bir plan sunduğunda ona geri bildirimde bulunabilir veya daha fazla ayrıntı ekleyebilirsiniz.

    We'd like to design this new screen using a design I've used before.
    [Image #1] Take a look at this image and use it as a reference.

    ArmIn verdiğiniz görselleri tarayıp prompt’a ekleyebilir. Bunu bir görseli terminale sürükleyip bırakarak yapabilirsiniz.

  3. Özelliği oluşturun

    Planı yeterli bulduğunuzda Tab tuşuna tekrar basarak _Build modu_\na dönün.

    <TAB>

    Ardından değişiklikleri yapmasını isteyin.

    Sounds good! Go ahead and make the changes.

Değişiklik Yapma

Daha basit değişikliklerde, önce planı incelemeden ArmIn’dan doğrudan değişiklik yapmasını isteyebilirsiniz.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

ArmIn’un doğru değişiklikleri yapması için yeterli ayrıntı verdiğinizden emin olun.

Değişiklikleri Geri Alma

Diyelim ki ArmIn’dan bazı değişiklikler yapmasını istediniz.

Can you refactor the function in @packages/functions/src/api/index.ts?

Ama istediğinin bu olmadığını anlıyorsun. /undo komutunu kullanarak değişiklikleri geri alabilirsiniz.

/undo

ArmIn değişiklikleri geri alır ve orijinal mesajınızı tekrar gösterir.

Can you refactor the function in @packages/functions/src/api/index.ts?

Buradan komut isteminde ince ayar yapabilir ve ArmIn’dan tekrar denemesini isteyebilirsiniz.

Veya /redo komutunu kullanarak değişiklikleri yeniden yapabilirsiniz.

/redo

Paylaşma

ArmIn ile yaptığınız görüşmeleri ekibinizle paylaşabilirsiniz.

/share

Bu, mevcut konuşmaya bir bağlantı oluşturacak ve bunu panonuza kopyalayacaktır.

İşte ArmIn ile bir örnek konuşma.

Özelleştirme

İşte bu kadar! Artık ArmIn’u kullanma konusunda profesyonelsiniz.

Kendinize göre uyarlamak için tema seçebilir, tuş atamalarını özelleştirebilir, kod biçimlendirici ayarlayabilir, özel komutlar oluşturabilir veya ArmIn config ile oynayabilirsiniz.