Skip to content

Configuration

Jump to bottom
nyxoraAI edited this page Jun 24, 2026 · 1 revision

Configuration Management

Nyxora uses an isolated and secure architecture to handle your settings, API keys, and sensitive Web3 configurations. Most settings can be adjusted directly from the Dashboard UI, but it's important to understand how they are stored.

The ~/.nyxora Directory

All of Nyxora's state is stored in your user's home directory under ~/.nyxora. This ensures your credentials and private settings are never accidentally committed to GitHub.

~/.nyxora/
├── config.yaml          # Core agent settings (LLM provider, base fiat, etc)
├── config/
│   ├── credentials.yaml # API keys for LLMs and services (OpenAI, Gemini, etc)
│   └── rpc_key.yaml     # Private RPC URLs for Web3 networks
├── policy.yaml          # Hard-coded firewall rules and transaction limits
└── data/
    └── memory.db        # Episodic memory database for the AI

Configuring LLM API Keys

To enable the AI agent, you must configure at least one LLM provider (e.g., Google Gemini, Anthropic Claude, or OpenAI).

Via Dashboard (Recommended):

  1. Open the Settings page in the dashboard.
  2. Select your preferred Provider from the LLM Engine section.
  3. Your keys are securely sent to the backend and stored in ~/.nyxora/config/credentials.yaml.

Via File: Edit ~/.nyxora/config/credentials.yaml directly:

gemini_key: "AIzaSy..."
anthropic_key: "sk-ant-..."
openai_key: ""

RPC Configuration

For the AI to execute Web3 transactions efficiently, it needs RPC endpoints.

Via Dashboard:

  1. Open the RPC Configuration tab in the sidebar.
  2. Enter your private Alchemy, Infura, or custom node URLs for networks like Ethereum Mainnet, Arbitrum, Base, etc.
  3. Click "Save". The backend stores these securely in ~/.nyxora/config/rpc_key.yaml.

Warning

Leaving an RPC field empty will trigger the agent's Public Fallback Mechanism, which is slower and susceptible to rate-limiting. It is highly recommended to use private RPC endpoints.

Agent Personalization

From the Settings page, you can also define:

  • Default Web3 Chain: The primary network the AI will use if a prompt doesn't specify one.
  • Base Fiat Currency: Display currency for your Portfolio.
  • Risk Tolerance Level: Instructs the AI on how conservative it should be when interacting with unknown smart contracts.

Clone this wiki locally