Skip to Content
aicentos

Reasonix

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

Last updated:

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

FieldValue
nameaicentos (local provider ID)
kindopenai (Chat Completions)
base_urlhttps://aicentos.com/v1
api_key_envAICENTOS_API_KEY
modelsA model name from the Model Gallery in the console

Setup steps

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

    npm i -g reasonix
  • Put the key into Reasonix's global .env:

    # 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):

    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:

    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