Sesi 4.7: Setup Environment

Kursus → Modul 4: Workspace

Sesi 7 dari 7

Setup Sekali, yang Bener

Setup environment itu fondasi ga glamor yang bikin semuanya jalan. Ini melibatkan instalasi Python, konfigurasi API key, manajemen dependency, dan memastikan proyek kamu bisa jalan di mesin manapun (atau mesin yang sama setelah update). Lakukan sekali, lakukan dengan benar, dan kamu ga perlu mikirin lagi. Lakukan asal-asalan, dan setiap sesi berikutnya ada sepuluh menit debugging masalah environment.

Setup environment itu infrastruktur. Kaya pipa ledeng di gedung, ga ada yang merhatiin waktu jalan lancar. Semua orang sadar waktu ga jalan. Luangkan waktunya sekarang. Diri kamu di masa depan ga perlu troubleshoot jam 11 malam waktu deadline mendekat.

Langkah 1: Instalasi Python

Python adalah bahasa yang dijalankan script kamu. Kebanyakan library API AI itu Python-first, yang artinya dokumentasi terbaik, contoh terbanyak, dan support tercepat semuanya mengasumsikan Python. Kalo Python udah terinstall, verifikasi versinya: python --version. Kamu butuh Python 3.9 atau lebih tinggi. Kalo belum terinstall, download dari python.org.

Waktu instalasi di Windows, centang kotak yang bertuliskan "Add Python to PATH." Satu centangan ini mencegah masalah instalasi paling umum: terminal ga bisa nemuin Python waktu kamu ketik perintahnya.

Langkah 2: Virtual Environment

Virtual environment itu salinan Python yang terisolasi buat proyek kamu. Package yang kamu install di satu proyek ga mempengaruhi proyek lain. Ini mencegah masalah "kemarin masih jalan" di mana update package buat Proyek A merusak Proyek B.

Perintah	Fungsinya
`python -m venv .venv`	Bikin virtual environment di folder `.venv`
`source .venv/bin/activate` (Mac/Linux)	Aktifkan virtual environment
`.venv\Scripts\activate` (Windows)	Aktifkan virtual environment di Windows
`pip install anthropic`	Install package di dalam virtual environment
`pip freeze > requirements.txt`	Simpan semua package terinstall ke file
`deactivate`	Keluar dari virtual environment

Waktu virtual environment aktif, prompt terminal kamu berubah (biasanya menampilkan (.venv) di awal). Semua perintah pip install sekarang menginstall ke proyek ini aja.

Langkah 3: File .env

API key itu password. Memberikan akses ke layanan berbayar. Ga boleh pernah muncul di kode kamu, ga boleh pernah di-commit ke Git, dan ga boleh pernah dibagikan. Solusi standarnya adalah file .env: file teks biasa di root proyek yang menyimpan pasangan key-value.

graph LR ENV["File .env
ANTHROPIC_API_KEY=sk-ant-..."] --> SCRIPT["generate.py
baca key dari .env"] SCRIPT --> API["Claude API
request terotentikasi"] GIT[".gitignore
berisi: .env"] -.->|memblokir| ENV style ENV fill:#222221,stroke:#c47a5a,color:#ede9e3 style SCRIPT fill:#222221,stroke:#6b8f71,color:#ede9e3 style API fill:#222221,stroke:#c8a882,color:#ede9e3 style GIT fill:#222221,stroke:#8a8478,color:#ede9e3

File .env kamu isinya kaya gini:

ANTHROPIC_API_KEY=sk-ant-your-key-here
OPENAI_API_KEY=sk-your-key-here
TAVILY_API_KEY=tvly-your-key-here

Script kamu membaca key ini pake package python-dotenv: pip install python-dotenv. Script memuat file, membaca key, dan memakainya buat autentikasi. Key-nya ga pernah muncul di kode kamu.

Langkah 4: File .gitignore

Langsung setelah bikin file .env, tambahkan ke .gitignore. Ini mencegah Git melacak atau meng-commit API key kamu. Ini bukan opsional. API key yang bocor mengakibatkan tagihan ga sah di akun kamu.

# Kredensial
.env
.env.local

# Python
__pycache__/
*.pyc
.venv/

# File OS
.DS_Store
Thumbs.db

# Raw output (bisa dibuang)
outputs/raw/

Langkah 5: File Requirements

File requirements.txt mencantumkan setiap Python package yang dibutuhkan proyek kamu. Waktu kamu setup proyek di mesin baru (atau berbagi ke kolaborator), satu perintah menginstall semuanya: pip install -r requirements.txt.

File requirements tipikal buat produksi konten AI:

anthropic>=0.25.0
openai>=1.30.0
python-dotenv>=1.0.0
tavily-python>=0.3.0

Checklist Setup Lengkap

graph TD A["Install Python 3.9+"] --> B["Bikin folder proyek"] B --> C["Bikin virtual environment"] C --> D["Aktifkan virtual environment"] D --> E["Install package"] E --> F["Bikin .env dengan API key"] F --> G["Bikin .gitignore"] G --> H["Inisialisasi Git repository"] H --> I["Commit pertama"] I --> J["Jalanin test script"] J --> K{"Semuanya jalan?"} K -->|Ya| L["Environment siap"] K -->|Ga| M["Minta AI assistant debug"] M --> J style A fill:#222221,stroke:#c8a882,color:#ede9e3 style F fill:#222221,stroke:#c47a5a,color:#ede9e3 style L fill:#222221,stroke:#6b8f71,color:#ede9e3

Bacaan Lanjutan

Python Virtual Environments, dokumentasi resmi Python
Claude API Initial Setup, dokumentasi Anthropic
OpenAI API Quickstart, dokumentasi OpenAI

Tugas

Bikin file .env di root proyek kamu dengan placeholder API key. Install package python-dotenv. Minta AI coding assistant kamu bikin script yang membaca API key dari .env dan print "API key loaded successfully" tanpa mencetak key yang sesungguhnya. Tambahkan .env ke file .gitignore kamu. Jalanin script-nya. Commit script dan .gitignore (bukan file .env) ke Git. Ini keamanan dasar.