Skip to main content

Contributing and community

Carina core is MIT licensed. You can install from npm, clone source, and contribute without a contributor agreement.

Start here

ResourceLink
Source (core only)github.com/malike2356/carina-agent
npm packagecarina-agent
Community hubcarinaai.uk/community
Questions and ideasGitHub Discussions
Bugs and featuresIssues
ConductCODE_OF_CONDUCT

The private carina-ai monorepo is VERLOX internal (ops, Scout server, deploy). Contributors work in carina-agent only.

Best first contribution: a skill pack

Skill packs are the lowest barrier and highest leverage path. You add domain workflows and knowledge without changing the agent core.

  1. Read Creating packs
  2. Study property-uk in the public repo under src/skills/packs/property-uk/
  3. Propose your pack with the skill pack issue template
  4. Open a PR or publish to skills.carinaai.uk

Development from source

git clone https://github.com/malike2356/carina-agent.git
cd carina-agent
pnpm install
pnpm build
pnpm test

See Getting started for Postgres, Redis, and first-run setup.

Code contributions

  • Fork carina-agent, branch from main
  • Run pnpm test and pnpm build before opening a PR
  • One focused change per PR when possible
  • Full guide: CONTRIBUTING.md

Look for issues labeled good first issue.

What to build together

AreaExamples
Skill packsFinance, legal, healthcare workflows (your domain expertise)
ToolsNew MCP-compatible tools with tests
GatewaysChannel adapter improvements, docs for setup
ProvidersNew LLM provider wiring
DocsTutorials, troubleshooting, examples

Commercial vs open source

Open (MIT)Commercial (VERLOX)
carina-agent coreCarina Cloud hosted SaaS
Skill packs you authorLabyrinth Scout security monitoring
Self-host with Docker/npmEnterprise trust and provisioning

You can self-host Carina for free under MIT and optionally add Scout or Cloud later.

Security

Report vulnerabilities privately per SECURITY.md. Do not open public issues for security bugs.