nyxora 1.4.1 → 1.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +50 -79
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -1,99 +1,70 @@
1
1
  # Nyxora Agent 🤖
2
2
 
3
- Nyxora is a next-generation, autonomous Web3 Agent built on Node.js and React. It operates directly on EVM-compatible blockchains, allowing users to execute on-chain actions simply by chatting with an intelligent LLM.
3
+ Nyxora adalah Agen Web3 otonom generasi berikutnya yang dibangun menggunakan Node.js dan React. Agen ini beroperasi secara langsung pada jaringan blockchain yang kompatibel dengan EVM (Ethereum, Arbitrum, Base, BSC, Optimism, dll.), memungkinkan Anda untuk mengeksekusi operasi on-chain hanya dengan mengobrol bersama AI.
4
4
 
5
- With a beautiful, real-time dashboard inspired by modern control centers, Nyxora brings an unparalleled user experience to blockchain automation.
5
+ Dilengkapi dengan antarmuka dasbor *Glassmorphism* yang menawan dan integrasi Telegram, Nyxora membawa pengalaman otomatisasi Web3 ke tingkat selanjutnya.
6
6
 
7
- ## Features ✨
7
+ ---
8
8
 
9
- ### 🧠 Core Agent Capabilities
10
- * **Multi-LLM Support**: Seamlessly switch between Google Gemini, OpenAI, OpenRouter (unlimited models!), or local Ollama models dynamically.
11
- * **Round-Robin API Rotation**: Add up to 10 API keys via the dashboard. The system will auto-rotate them to prevent rate-limiting and token drain.
12
- * **Deep Personalization**: Feed the agent custom rules via `user.md` and define its core persona via `IDENTITY.md`.
13
- * **Multi-Lingual Auto-Sync**: The agent natively detects your language and replies in the exact same language automatically.
9
+ ## Kemampuan & Fitur (Skills)
14
10
 
15
- ### 🛡️ Production-Ready Security (NEW in v1.0.10)
16
- * **Encrypted Local Keystore**: No more `.env` leaks. Your Private Key is encrypted using `AES-256-GCM` and locked behind a custom **Master Password**.
17
- * **Human-in-the-Loop Sandboxing**: The agent CANNOT execute transactions on its own. All transactions (Transfers & Swaps) are queued in a **Transaction Manager** and require explicit 1-click Approval from you.
18
- * **Omnichannel Approvals**: Approve or reject pending transactions directly from the Web Dashboard's UI or via Telegram Inline Keyboard buttons on the go!
19
- * **Strict API Auth**: The local Express server is protected via ephemeral Session Tokens (`x-nyxora-token`) and Strict CORS, preventing unauthorized local API requests.
11
+ Agen ini memiliki berbagai *skills* bawaan yang memungkinkannya berinteraksi dengan blockchain maupun sistem operasi lokal Anda.
20
12
 
21
- ### ⛓️ Web3 DeFi Skills (Pro-Trader AI)
22
- * **Multi-Chain Support**: Operate across Ethereum, Base, BSC, Arbitrum, Optimism, and Sepolia Testnet.
23
- * **Wallet Generation**: Instruct the AI to generate new EVM wallets on the fly securely (Keys are never saved).
24
- * **Native Wallet Operations**: Autonomously check balances and transfer native tokens using securely injected wallets.
25
- * **Advanced Market Intelligence**: Fetch live crypto prices, 24h market movements, FDV, and liquidity via CoinGecko and DexScreener integrations.
26
- * **Anti-Rugpull & Security Scanner**: Nyxora can scan smart contracts via GoPlus Labs to detect Honeypots, Hidden Taxes, and malicious proxy upgrades before you buy.
27
- * **PNL & Portfolio Tracking**: The AI scans your wallets and multiplies balances by live DEX prices to give you real-time Net Worth estimations.
28
- * **DeFi Token Swapping & Bridging**: The agent can autonomously simulate liquidity routes and execute token swaps or cross-chain bridges with gas fee estimations.
29
- * **Automated Limit Orders (Take-Profit/Cut-Loss)**: Set rules (e.g., "Sell my PEPE if price drops below $0.001"). Nyxora runs a background cron monitor and automatically executes the swap while you sleep without requiring manual approval!
13
+ ### 1. Manajemen Wallet & Saldo
14
+ Nyxora dibekali dengan dompet (wallet) bawaan yang terenkripsi aman secara lokal.
15
+ * **Generate Wallet:** Anda dapat memerintahkan AI untuk membuat dompet EVM baru secara instan.
16
+ * **Cek Saldo & Portofolio:** Memeriksa saldo koin native (ETH, BNB, MATIC) atau token ERC-20, serta menghitung total kekayaan (Net Worth) secara real-time.
30
17
 
31
- ### ⚙️ Web3-Ops & System Automation (NEW in v1.4.1)
32
- * **NLP Security Policy**: Command Nyxora using natural language to set security boundaries (e.g., *"Never touch partition E" or "Do not install global packages"*). Nyxora autonomously enforces these rules and will pause to ask for your explicit permission if an action violates them.
33
- * **Full OS Access**: Instruct the agent to read/write local files, run terminal commands, and browse the web natively.
34
- * **Plugin Manager**: Dynamically load community-built skills. Simply provide a GitHub Gist URL, and Nyxora will download, install, and hot-load the third-party skill directly into its `external_skills` directory.
18
+ ### 2. Kirim Koin / Token (Transfer)
19
+ Mengirim koin native atau token ERC-20 ke alamat lain secara otonom.
35
20
 
36
- ### 💻 The Interface (Live Canvas)
37
- * **Premium Glassmorphism UI**: A gorgeous, resizable split-pane interface.
38
- * **Pseudo-Generative UI**: Instead of raw text, the agent dynamically renders interactive widgets (`<BalanceWidget>`, `<MarketWidget>`, `<SwapWidget>`) onto the "Live Canvas" when executing Web3 skills.
39
- * **JARVIS Voice Mode**: Completely hands-free! Uses browser Native Text-to-Speech (TTS) to read AI responses and Auto-Listen loops to capture your next voice command without clicking.
21
+ ### 3. Swap & Bridge Lintas Jaringan
22
+ * **Swap Token:** Menukar token di jaringan yang sama dengan simulasi rute likuiditas dan estimasi gas.
23
+ * **Bridge Lintas Jaringan:** Mengirim dan menukar token dari satu jaringan ke jaringan lainnya (misal: Arbitrum ke Base).
40
24
 
41
- ### 📱 Telegram Integration
42
- * Take your agent anywhere! Connect Nyxora to a Telegram Bot to execute trades, check prices, and chat on the go.
25
+ ### 4. Limit Order Otomatis (Take-Profit/Cut-Loss)
26
+ Anda dapat menetapkan aturan khusus dalam bahasa natural (misal: *"Jual PEPE saya jika harga turun di bawah $0.001"*). Nyxora akan menjalankan pemantauan (cron monitor) di latar belakang dan mengeksekusi *swap* secara otomatis saat Anda tidur!
43
27
 
44
- ## Quick Start 🚀 (Global Install)
28
+ ### 5. Analisis Market & Keamanan (Anti-Rugpull)
29
+ * **Market Intelligence:** Mengambil harga kripto secara live, pergerakan pasar 24 jam, dan likuiditas (terintegrasi dengan CoinGecko & DexScreener).
30
+ * **Security Scanner (GoPlus Labs):** Agen dapat memindai *smart contract* untuk mendeteksi Honeypot, pajak tersembunyi (Hidden Taxes), dan proksi berbahaya sebelum Anda membeli token.
45
31
 
46
- Nyxora is now available on NPM! You can install it as a global CLI tool on your operating system.
32
+ ### 6. Otomatisasi Sistem & Plugin (NEW v1.4.1)
33
+ Nyxora kini memiliki kemampuan akses OS tingkat lanjut (layaknya OpenClaw):
34
+ * **Full OS Access:** Mampu membaca/menulis *file* lokal, mengeksekusi perintah terminal (Shell/PowerShell), dan melakukan *browsing* web secara natif.
35
+ * **Plugin Manager:** Muat *skill* pihak ketiga secara dinamis. Cukup berikan URL GitHub Gist, dan Nyxora akan mengunduh serta menginstalnya secara otomatis ke dalam direktori `external_skills`.
47
36
 
48
- ### 1. Installation
49
- Open your terminal (Command Prompt, PowerShell, or Linux Terminal) and run:
37
+ ---
38
+
39
+ ## Panduan Perilaku Agent & Keamanan
40
+
41
+ Nyxora dirancang dengan protokol keamanan tingkat tinggi dan personalisasi mendalam:
42
+
43
+ 1. **Personalisasi (Prompt Tambahan):** Perilaku AI dapat diatur sepenuhnya dengan mengedit *file* `IDENTITY.md` dan `user.md`. Agen akan mendeteksi bahasa Anda secara otomatis dan membalas dengan bahasa yang sama.
44
+ 2. **Keamanan Otonom (NLP Security Policy):** Anda dapat memberikan batasan keamanan menggunakan bahasa natural (misal: *"Jangan pernah mengakses partisi E"* atau *"Jangan instal aplikasi global"*). Aturan ini disimpan di `security_policy.md` dan Nyxora akan dengan patuh menolaknya jika ada instruksi yang melanggar.
45
+ 3. **Human-in-the-Loop Sandboxing:** Agen **TIDAK AKAN PERNAH** mengeksekusi transaksi finansial (Transfer/Swap) secara sepihak. Semua transaksi akan masuk ke **Transaction Manager** dan menunggu persetujuan (*Approve/Reject*) 1-klik dari Anda via Web Dashboard atau tombol Telegram.
46
+ 4. **Keamanan Keystore:** Private Key Anda dienkripsi menggunakan `AES-256-GCM` dan dikunci oleh Master Password Anda sendiri. Tidak ada data sensitif yang bocor ke file `.env`.
47
+
48
+ ---
49
+
50
+ ## Cara Instalasi & Penggunaan 🚀
51
+
52
+ Nyxora tersedia di NPM dan dapat diinstal secara global di sistem operasi Anda.
53
+
54
+ ### 1. Instalasi Global
55
+ Buka terminal Anda (Command Prompt, PowerShell, atau Linux Terminal) dan jalankan:
50
56
  ```bash
51
57
  npm install -g nyxora
52
58
  ```
53
59
 
54
- ### 2. Launching Nyxora
55
- No need to navigate to any specific folder! Just type:
60
+ ### 2. Menjalankan Nyxora
61
+ Cukup ketik perintah berikut di mana saja:
56
62
  ```bash
57
63
  nyxora
58
64
  ```
59
- On first launch, Nyxora will greet you with an **Interactive Setup Wizard**. This CLI wizard will guide you to securely configure your LLM providers, API keys, and Web3 Wallet.
60
-
61
- Nyxora will automatically:
62
- 1. Initialize a secure vault in your `~/.nyxora/` directory.
63
- 2. Store your Wallet Private Key securely in an encrypted `~/.nyxora/keystore.json` locked by your Master Password.
64
- 3. Store operational data (API Keys, RPCs) in `~/.nyxora/config.yaml`.
65
- 4. Start the local server, generate a secure Session Token, and open the Web Dashboard automatically!
66
-
67
- > 💡 **Tip:** You can invoke the setup wizard at any time to update your keys by running `nyxora setup`.
68
-
69
- ### 3. Configuration
70
- When the dashboard opens, you can modify any operational parameters in the **Settings** tab. The dashboard allows you to type custom model names, switch RPCs, and rotate your API keys effortlessly.
71
-
72
- ## Local Development (For Contributors) 🏗️
73
-
74
- If you want to modify Nyxora's code, build new skills, or contribute:
75
-
76
- 1. Clone the repo:
77
- ```bash
78
- git clone https://github.com/perasyudha/Nyxora.git
79
- cd Nyxora
80
- ```
81
- 2. Install dependencies:
82
- ```bash
83
- npm install
84
- cd dashboard && npm install && cd ..
85
- ```
86
- 3. Run the development build:
87
- ```bash
88
- npm run build && npm run start
89
- ```
90
-
91
- *To deploy your own branch to NPM, bump the version and run `npm run deploy`!*
92
-
93
- ## Architecture
94
- * **Backend**: Node.js, Express, Viem (Web3), node-telegram-bot-api, OpenAI API.
95
- * **Frontend**: React, Vite, Vanilla CSS, Web Speech API (TTS/STT).
96
- * **Data**: Local `~/.nyxora/config.yaml` and `~/.nyxora/memory.json`.
97
-
98
- ## License
99
- MIT License
65
+ Pada peluncuran pertama, Nyxora akan menyapa Anda dengan **Interactive Setup Wizard** yang akan memandu Anda untuk mengatur konfigurasi LLM (OpenAI, Gemini, Ollama, OpenRouter), API Keys, dan Master Password Wallet.
66
+
67
+ > 💡 **Tips:** Anda dapat memanggil wizard pengaturan kapan saja untuk memperbarui kunci Anda dengan menjalankan perintah `nyxora setup`.
68
+
69
+ ### 3. Dasbor Web & Interaksi
70
+ Setelah peladen (*server*) berjalan, Dasbor Web akan terbuka secara otomatis di *browser* Anda. Anda dapat berinteraksi langsung melalui antarmuka *Glassmorphism* Premium atau menghubungkannya ke Bot Telegram untuk akses dari mana saja.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "nyxora",
3
- "version": "1.4.1",
3
+ "version": "1.4.2",
4
4
  "description": "",
5
5
  "main": "dist/gateway/cli.js",
6
6
  "files": [