Skip to main content

​
Installation issues

Ensure Node.js 18+ is installed:
node --version  # should be >= 18
Try installing globally:
npm install -g complior
Ensure Rust 2024 edition toolchain:
rustup update stable
cargo build --release
If OpenSSL errors, install system deps:
# Ubuntu/Debian
sudo apt install libssl-dev pkg-config
# macOS
brew install openssl
Avoid sudo npm install -g. Instead, configure npm prefix:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH"

​
Daemon issues

Check for existing process:
complior daemon status
If stale, remove PID file and restart:
rm .complior/daemon.pid
complior daemon start
Or use a different port:
complior daemon start --port 4000
The TUI couldn’t reach the daemon. Check if it’s running:
complior daemon status
curl http://localhost:3578/status
If not running, the TUI will auto-start it. If it still fails, check the engine log:
cat engine/core/engine.log
Check system resources — the TypeScript engine needs ~200MB RAM. Review the engine log for errors:
cat engine/core/engine.log | tail -50

​
Scan issues

This is expected for projects without compliance artifacts. Run the fix command to generate documents and wrap SDK:
complior fix --dry-run  # preview first
complior fix            # apply
Default limit is 500 files. Large monorepos can be slow. Narrow scope in project.toml:
[scan]
include = ["src/**"]
exclude = ["node_modules", "dist", "vendor"]
max_files = 300
Report via GitHub Issues. Workaround — exclude the file:
[scan]
exclude = ["path/to/false-positive.ts"]
Tier 2 requires uv (Python tool installer):
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh

# Check tools
complior tools status
complior tools update

​
LLM issues

Check .complior/.env has valid credentials:
cat .complior/.env
Required fields:
LLM_PROVIDER=anthropic
LLM_MODEL=claude-sonnet-4-20250514
LLM_API_KEY=sk-ant-...
Verify the key:
complior doctor
Reduce concurrency:
complior eval http://localhost:8080/api -j 2
Default is 5 parallel probes. For rate-limited APIs, use 1–2.

​
SDK issues

Ensure you have the latest version:
npm install @complior/sdk@latest
Check tsconfig.json includes "moduleResolution": "bundler" or "node16".
Verify the wrapper is applied correctly:
import { complior } from '@complior/sdk';
import OpenAI from 'openai';

// Correct — wraps the client
const client = complior(new OpenAI(), { disclosure: true });

// Wrong — complior must wrap the constructor result
const client = new OpenAI();
complior(client); // This doesn't capture the proxy

​
Still stuck?

GitHub Issues

Report bugs and request features.

System diagnostics

Run complior doctor to check your environment.