Eir Open open.eir.space
Back to docs

Documentation

Contributing

How to get involved with eir-open — code, documentation, clinical review, or advocacy.

eir-open is a community project. Whether you are a developer, healthcare professional, researcher, or patient advocate, there is a meaningful way to contribute.

Ways to Contribute

Code

Parser improvements, new language bindings, CLI features, integrations with EHR systems and agent frameworks.

Documentation

Improve clarity, add examples, fix inaccuracies, translate content, or document undocumented features.

Clinical Review

Validate terminology accuracy, propose specialty extensions (cardiology, oncology, mental health), share clinical workflow insights.

Community

Open issues, participate in discussions, advocate for adoption, or help other users in GitHub Discussions.

Project Repositories

ProjectRepositoryStack
Swedish Medicationseir-space/swedish-medicationsNode.js
US FDA Medicationseir-space/us-medicationsNode.js
Health.md Standardeir-space/health-md-standardPython
EIR MCP Servereir-space/eir-mcp-serverNode.js
Eir Open Appseir-space/eir-open-appsSwift
EIR Provider Directoryeir-space/eir-open/apps/eir-provider-directoryReact / Cloudflare
eir-open (this site)eir-space/eir-openAstro / MDX

Good First Issues

These are high-priority areas where the project needs help:

  • JavaScript parser library — expand health-md parsing beyond Python
  • FHIR integration — bidirectional conversion between EIR format and FHIR resources
  • Clinical validation studies — real-world testing and accuracy review
  • EHR integrations — Epic, Cerner, Allscripts connectors
  • Specialty extensions — structured sections for cardiology, oncology, mental health

Browse open issues and look for good first issue and help wanted labels.

Contribute to CBT Programs (high impact)

If you want to help quickly, this is one of the most useful contribution paths:

  1. Pick a program under skills/cbt-programs/data/programs/<id>/.
  2. Improve content quality, safety language, or recommendation signals.
  3. Add or improve translations in locales/<lang>.json.
  4. Update translation review status in program.json.
  5. Run validation and open a PR.

Useful commands:

Terminal window
cd skills/cbt-programs
node scripts/cbt_programs.js list
node scripts/cbt_programs.js improve cbt-insomnia --interactive --dry-run
node scripts/cbt_programs.js validate

For a full workflow guide, see CBT Programs Registry.

Dev Setup

To run the docs site locally:

Terminal window
git clone https://github.com/eir-space/eir-open.git
cd eir-open/site
pnpm install
pnpm dev

The site will be available at http://localhost:4321/eir-open/.

Standards

When contributing to eir-open projects:

  • Backward compatibility — don’t break existing Health.md files or CLI interfaces
  • Clinical accuracy — validate changes with healthcare professionals or cite sources
  • Privacy-first — always consider data protection implications; never commit real patient data
  • LLM-optimized — structured output should be easy for AI systems to parse and reason about

Community