Running NeuAIs Development Tools

Prerequisites

1. Generate tool configs:

cd neuais.com/automation
./cli/perfection generate manifest/neuais-complete.csv

2. Setup Postgres database:

createdb neuais

Start NeuAIs Git

cd neuais.com/automation
./run-gitarena.sh

Accessible at: http://localhost:3000

First time setup:

1. Create admin account via web UI
2. Update settings table in database to enable admin panel
3. Access admin panel at: http://localhost:3000/admin

Start NeuAIs IDE

cd neuais.com/automation
./run-lapdev.sh

Accessible at: http://localhost:3001

First time setup:

1. Create user account
2. Configure Kubernetes cluster (if using K8s features)
3. Create workspace

Configuration Files

Generated at:

• generated/tools/git/config.env - GitArena config
• generated/tools/ide/config.env - Lapdev config

Edit environment variables:

• BIND_ADDRESS - Server address
• DATABASE_URL - Postgres connection string
• INSTANCE_NAME - Display name
• THEME - UI theme (dark)

Verify

# Check GitArena
curl http://localhost:3000/health

# Check Lapdev
curl http://localhost:3001/health

Troubleshooting

Build errors:

• Ensure Rust toolchain installed: rustup update stable
• Check cargo version: cargo --version

Database errors:

• Verify Postgres running: pg_isready
• Check connection string in config.env
• Create database: createdb neuais

Port conflicts:

• Change ports in manifest CSV
• Regenerate configs

Integration with Manifest

Both tools are defined in automation/manifest/neuais-complete.csv:

tool,git,NeuAIs Git server,gitarena,rust,...,3000
tool,ide,NeuAIs IDE server,lapdev,rust,...,3001

When manifest changes, regenerate configs:

./cli/perfection generate manifest/neuais-complete.csv

Branding

Both tools use NeuAIs branding:

• Logo: Black lightning bolt
• Colors: Black, white, grey only
• Theme: Dark mode default
• Instance names: “NeuAIs Git”, “NeuAIs IDE”

Branding applied via:

• CSS overrides (neuais-brand.css)
• HTML templates
• Config defaults

Location: docs-internal/guides/
Related: docs-internal/integration/gitarena-lapdev-rebranding.md