# Reasonix

Source: https://docs.aicentos.com/en/clients/reasonix

Language: en

> Use aicentos in Reasonix — add a custom provider through config.toml

Reasonix is a local coding agent (a CLI/TUI, desktop app, browser UI and an editor ACP entry point, all sharing the same engine). It has no built-in aicentos provider, but you can add an OpenAI-compatible `[[providers]]` entry to `~/.reasonix/config.toml` and route requests to aicentos.

## Prerequisites

Create a dedicated key in the aicentos console (naming it `reasonix-cli` is recommended). Reasonix stores provider keys in its own global `.env` file and does not read shell environment variables.

## Configuration to fill in

| Field         | Value                                              |
| ------------- | -------------------------------------------------- |
| name          | `aicentos` (local provider ID)                     |
| kind          | `openai` (Chat Completions)                        |
| base\_url     | `https://aicentos.com/v1`                          |
| api\_key\_env | `AICENTOS_API_KEY`                                 |
| models        | A model name from the Model Gallery in the console |

## Setup steps

* Install Reasonix (npm, or Homebrew on macOS):

  ```bash
  npm i -g reasonix
  ```

* Put the key into Reasonix's global `.env`:

  ```bash
  # macOS / Linux
  echo 'AICENTOS_API_KEY=your_api_key_here' >> ~/.reasonix/.env

  # Windows: %APPDATA%\reasonix\.env
  ```

* Edit `~/.reasonix/config.toml` and merge in the following (do not remove your other existing providers):

  ```toml
  default_model = "aicentos"

  [[providers]]
  name          = "aicentos"
  kind          = "openai"
  base_url      = "https://aicentos.com/v1"
  models        = ["claude-sonnet-5", "deepseek-v4-pro", "qwen3-coder-plus"]
  default       = "claude-sonnet-5"
  api_key_env   = "AICENTOS_API_KEY"
  context_window = 200000
  ```

* Start it from a project directory:

  ```bash
  reasonix
  ```

  You can also verify with a one-off task first: `reasonix run "Explain in one sentence what project the current directory is"`. On the desktop app, go through **Settings → Model → Access → Add model service → Custom provider** instead.

## Test

After starting, send a simple prompt and confirm responses stream back normally. Use `/model` inside the session to switch models.

## Notes

* `base_url` should only go up to `/v1`; Reasonix appends `/chat/completions` itself.
* The key must be written to `~/.reasonix/.env`; `export`-ing it in the shell or putting it in a project `.env` will not be recognized as the provider key.
* Choose `openai` for `kind`; the native `anthropic` type maps to the Anthropic Messages endpoint and does not fit here.
* `default_model` takes the provider's `name` (`aicentos`), not a model name.
* If the desktop app's custom provider form asks for the full address, enter `https://aicentos.com/v1/chat/completions`.
* Project page: `https://github.com/esengine/DeepSeek-Reasonix`