Skip to main content

Cloudflare-first agentic coding CLI untuk developer Indonesia dan global

Project description

autokeren

Cloudflare-first agentic coding CLI untuk developer Indonesia dan global.

autokeren adalah CLI agentic coding yang dirancang khusus untuk stack Cloudflare-first. Dibangun dengan Python, mendukung 7 model AI dengan fallback otomatis, dilengkapi tools bawaan untuk file, shell, git, deploy Cloudflare, serta PaaS built-in untuk deploy aplikasi langsung dari terminal.

CI License: MIT Python 3.11+ PyPI


Fitur Utama

  • 7 model AI — kimi-code, kimi-2.6, glm-5.2, glm-flash, llama-4-scout, gemma-4, nemotron dengan fallback otomatis.
  • PaaS built-in — deploy aplikasi ke Cloudflare Workers langsung dari terminal, auto D1 + R2 + AI bindings.
  • Streaming output — respons token-by-token langsung di terminal.
  • Permission system — konfirmasi sebelum menjalankan command berbahaya atau menulis file.
  • Cross-session memory — ingatan per-project tersimpan otomatis, dimuat tiap startup.
  • Session save/resume — simpan state percakapan, lanjutkan kapan saja.
  • Context tracking + /compact — pantau pemakaian context window, ringkas otomatis atau manual.
  • AGENTS.md support — instruksi per-project untuk AI agent dimuat otomatis.
  • Markdown rendering — output model dirender dengan warna (heading, table, code block).
  • KV/D1/PaaS tools — baca/tulis KV, query D1, create/deploy project langsung dari agent.
  • Tmux supervisor — spawn dan monitor long-running agent yang survive terminal close.
  • CF Pages/Workers deploy — helper deploy + build terintegrasi.

Cara Mulai

1. Dapatkan API Key (gratis)

Daftar di developers.autokeren.com untuk dapatkan API key gratis. Free tier: 20 request/menit.

2. Install

pipx install autokeren

Kalau belum punya pipx: sudo apt install pipx && pipx ensurepath Alternatif: pip install --user autokeren

3. Login

autokeren --login

Masukkan API key dari developers.autokeren.com. Selesai.

4. Mulai ngoding

autokeren

Quick Start

Interactive chat

autokeren

Single prompt

autokeren "buat file hello.py yang cetak hello world"

Plan mode

autokeren --plan

Pilih model

autokeren -m glm "refactor fungsi ini"
autokeren -m kimi "tulis unit test untuk modul tools"

Deploy aplikasi

autokeren "deploy toko sepatu sederhana dengan HTML+CSS, pakai D1 untuk produk"

Agent akan otomatis create project, tulis kode, dan deploy ke Cloudflare Workers dengan D1 + R2 bindings.

Contoh percakapan

> baca pyproject.toml dan tambahkan field authors
> deploy project ini ke Cloudflare Pages
> jalankan pytest dan perbaiki test yang gagal
> buat web toko sederhana, deploy langsung
> simpan preferensi build ini ke memory

Model Tersedia

Alias Model
kimi-code Moonshot Kimi K2.7-Code (primary)
kimi-2.6 Moonshot Kimi K2.6
glm-5.2 Zai GLM 5.2 (secondary)
glm-flash Zai GLM Flash
llama-4-scout Meta Llama 4 Scout
gemma-4 Google Gemma 4
nemotron NVIDIA Nemotron

Pilih dengan -m <alias>. Default: kimi-code dengan fallback ke glm-5.2.

Commands

Perintah slash di interactive mode:

Perintah Deskripsi
/help Tampilkan bantuan dan daftar perintah
/q atau /quit Keluar dari sesi
/status Tampilkan status context window, model aktif, dan info sesi
/compact Ringkas history percakapan, pertahankan N turn terakhir
/reset Reset sesi percakapan saat ini
/memory Tampilkan lokasi dan isi memory per-project
/save [nama] Simpan sesi saat ini
/resume <nama|id> Lanjutkan sesi tersimpan
/sessions Daftar semua sesi tersimpan

Tools

autokeren membawa 21 tools bawaan dengan permission check dan schema function-calling.

Tool Deskripsi
read_file Baca isi file
write_file Tulis file baru atau overwrite
patch_file Patch file dengan search-and-replace
list_files List file dalam direktori (glob pattern)
run_shell Jalankan shell command dengan allowlist + blocklist
search_code Cari konten file dengan regex
fetch_url Ambil konten URL
git_status Status working tree git
git_diff Diff git (staged/unstaged)
git_commit Commit perubahan
cf_deploy Deploy ke Cloudflare Pages/Workers via wrangler
cf_build_next Build Next.js dengan next-on-pages
cf_kv Baca/tulis Cloudflare KV namespace
cf_d1 Jalankan query Cloudflare D1
create_project Buat project PaaS baru (auto D1 + R2 + AI bindings)
deploy_project Deploy code ke project PaaS
list_projects Daftar project PaaS yang sudah dibuat
tmux Supervisor long-running task via tmux
todo Kelola todo list multi-step
remember Simpan info ke cross-session memory

Konfigurasi

Konfigurasi disimpan di ~/.config/autokeren/config.yaml.

cloudflare:
  api_key: ""            # API key dari developers.autokeren.com
  primary_model: "kimi-code"
  secondary_model: "glm-5.2"
  max_tokens: 16384
  temperature: 0.3
  timeout: 120.0

retry:
  max_retries: 5
  base_delay: 1.0
  max_delay: 60.0
  exponential_base: 2.0
  jitter: true
  circuit_failure_threshold: 5
  circuit_open_seconds: 30

autokeren:
  plan_mode: false
  max_iterations: 25
  shell_timeout: 180
  shell_allowlist: ["node", "npm", "pnpm", "npx", "git", "wrangler", "python3", "pytest"]
  project_root: "."
  context_window: 262144
  compact_tail_turns: 6
  auto_compact: false
  auto_compact_threshold: 0.8

Environment variables

Variable Deskripsi
AUTOKEREN_API_KEY API key dari developers.autokeren.com (override config)
AUTOKEREN_CONFIG_DIR Direktori konfigurasi custom (default ~/.config/autokeren)

Update

pipx upgrade autokeren

Arsitektur

cli.py ──> agent.py (core loop) ──> models/ (Cloudflare client + router + retry)
                                     tools/ (Tool base + registry + 21 tools)
                                     context.py (session memory + token tracking)
                                     memory.py (cross-session memory)
                                     session.py (save/resume)
                                     ui.py (rich terminal UI + markdown)

Contributing

Kontribusi sangat diterima. Fork, buat branch, kirim PR.

git clone https://github.com/autokeren/autokeren.git
cd autokeren
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

Sebelum commit, pastikan ruff check ., mypy autokeren, dan pytest semua lulus.

License

MIT — lihat LICENSE.

Disclaimer

autokeren adalah proyek independen dan tidak berafiliasi dengan, diendorsing oleh, atau sponsori oleh Cloudflare, Inc. "Cloudflare" serta produk terkait adalah merek dagang Cloudflare, Inc. autokeren menggunakan infrastruktur dan API publik Cloudflare (Workers AI, D1, R2, KV, Pages) sebagai layanan pihak ketiga.

Project details


Release history Release notifications | RSS feed

This version

0.4.2

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autokeren-0.4.2.tar.gz (70.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

autokeren-0.4.2-py3-none-any.whl (65.7 kB view details)

Uploaded Python 3

File details

Details for the file autokeren-0.4.2.tar.gz.

File metadata

  • Download URL: autokeren-0.4.2.tar.gz
  • Upload date:
  • Size: 70.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for autokeren-0.4.2.tar.gz
Algorithm Hash digest
SHA256 164382237d2c2bfa320d8ec80329bd9f0f7d0e7cb0e273e82f78add79c50d5e0
MD5 5c928b8b563f66b320e920bdc815e7a0
BLAKE2b-256 797a414eb50722198ba48e54887490067eb5b5f7583ca6686c64d35c12ebb2b2

See more details on using hashes here.

File details

Details for the file autokeren-0.4.2-py3-none-any.whl.

File metadata

  • Download URL: autokeren-0.4.2-py3-none-any.whl
  • Upload date:
  • Size: 65.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for autokeren-0.4.2-py3-none-any.whl
Algorithm Hash digest
SHA256 6b77144960083fe23c861e51449e771d35cc3dc1e0611505169a033946311703
MD5 41d87a5611578fc8e391ced415b32460
BLAKE2b-256 789fbdf6aa41df083fec35a0f9fab809cc00c470739197b02f3d6ea6fe2ec329

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page