ALMA AI - Adaptive Learning Modular Agent Core Framework
npm install alma-ai-core---
Dibangun dengan filosofi open source dan modularitas tinggi, ALMA memampukan developer untuk menciptakan agen AI yang resilien, terukur, dan canggih β sesuai visi masa depan sistem AI yang mampu berpikir dan beradaptasi secara mandiri.
---
---
alma.getStatus() memberikan visibilitas runtime secara real-time.---
---
``bashMenggunakan npm
npm install alma-ai-core @google/generative-ai chokidar
> Catatan:
> -
@google/generative-ai diperlukan jika Anda menggunakan Gemini.
> - chokidar digunakan untuk fitur monitoredFiles.
> - Untuk Groq atau ChatGPT, instal library tambahan seperti groq-sdk atau openai.---
π Quick Start
`javascript
import { AlmaAI } from 'alma-ai-core';const alma = new AlmaAI({
providers: {
gemini: {
apiKeys: [process.env.GEMINI_KEY],
defaultModel: 'gemini-2.5-flash'
},
groq: {
apiKeys: [process.env.GROQ_KEY],
defaultModel: 'llama3-8b-8192'
}
},
providerFallbackOrder: ['gemini', 'groq']
});
async function run() {
console.log(await alma.generate("Apa itu ALMA AI?"));
alma.shutdown();
}
run();
`---
ποΈ Arsitektur & Logika Inti
ALMA terdiri dari tiga komponen utama:
- Core (alma-core.js) β Mengatur event, state, dan logika utama.
- Providers (alma-providers.js) β Berinteraksi dengan API eksternal.
- State Manager (alma-state.js) β Menyimpan status key, statistik, dan fallback.Setiap proses
generate() melewati:
1. Penyusunan prompt.
2. Pemilihan provider dan model.
3. Validasi API key aktif.
4. Eksekusi panggilan API.
5. Penyimpanan state & logging hasil.---
π§ AC Core Cavity (Artificial Consciousness)
Fitur eksperimental yang memberi βdetak jantungβ pada agen AI.
Menyediakan event acPulse dan proactiveAction untuk mendukung perilaku proaktif.Contoh:
`js
alma.on('acPulse', () => {
const shouldAct = Math.random() < 0.1;
if (shouldAct) alma.triggerProactiveAction({ reason: "Heartbeat check" });
});
`---
ποΈ Kesadaran Kontekstual & File Monitoring
ALMA dapat memantau file dan menyuntikkan isinya ke dalam prompt.`js
const alma = new AlmaAI({
monitoredFiles: [{ path: './docs/faq.md', contextName: 'FAQ' }]
});
`
Ketika file berubah, ALMA akan memperbarui memorinya secara otomatis.---
π Manajemen State & Statistik
State disimpan dalam .alma_state/alma_state.json dan meliputi:
- Status Key (aktif, limit, error)
- Statistik (total request, total error)
- History Provider untuk debugging---
π£οΈ Roadmap
| Versi | Fitur Utama | Status |
|--------|--------------|---------|
| v0.2.0 | Task Continuation & Memory Loop | β³ Dalam pengembangan |
| v0.3.0 | Plugin System untuk Provider Baru | π§ Dirancang |
| v0.4.0 | Self-Correction Engine | π‘ Rencana |
| v0.5.0 | Redis-based State Persistence | π¬ Eksperimen |
| v1.0.0 | Stabil & Dokumentasi Lengkap | π― Target 2026 |---
π€ Kontribusi
Kontribusi Anda sangat dihargai!
1. Fork repositori ini.
2. Buat branch baru (fitur/nama-fitur`). Laporkan bug dan usulan melalui Issue Tracker.
---
---
> ALMA AI β βLearning, Adapting, and Growing Toward Awareness.β