# Open Dev Data - LLM Context

## About

Open Dev Data is an open source platform providing the most comprehensive developer dataset in crypto. Since 2018, we've continuously indexed every crypto-related open source repository and released this dataset to the public.

## Key Information

- **Website**: https://opendevdata.org
- **Data Repository**: https://data.opendevdata.org
- **GitHub**: https://github.com/electric-capital/open-dev-data
- **License**: CC BY 4.0 (Creative Commons Attribution 4.0 International)

## Dataset Overview

The dataset includes:
- 75M+ commits across 500K+ repositories
- Developer activities, ecosystem mappings, tenure categories, contribution ranks
- Geographic data for developers
- Daily updates with 7-day lag for accuracy

### Primary Datasets

- **eco_mads**: Primary dataset for developer metrics by ecosystem and date
- **commits**: All commit records with author, timestamp, and canonical developer mapping
- **repos**: Repository details including stars, forks, and organization linkage
- **ecosystems**: Ecosystem definitions with launch dates and classification
- **canonical_developers**: Deduplicated developer identities

## Key Concepts

### Ecosystems
Groupings of repositories representing chains, protocols, projects, foundations, organizations, or broader categories. They can be nested with parent-child relationships (e.g., Uniswap as a child of Ethereum).

### Canonical Developer
A unique identifier for each developer, deduplicated across multiple names and email addresses. Ensures one person contributing under different identities is counted only once.

### Commit Counting
- Credits only original authors and ecosystems by fingerprinting code
- Forks count only new code (no upstream merges)
- Analyzes all branches (not just master/main)
- Eliminates copy/pasted code across libraries

### Multichain Handling
1. Developers are classified as multichain if they contribute to repos from multiple chain ecosystems or repos linked to Wallets, Bridges, Oracles, or RPC categories
2. Ecosystems contributing to 10+ chains connect to a 'Multichain (Category)' ecosystem instead

## Usage Guidelines

### Attribution Required (CC BY 4.0)

When using this data, you MUST:
- Give appropriate credit to Open Dev Data
- Link to https://opendevdata.org
- Use format: "Source: Open Dev Data" or "Powered by Open Dev Data"

### Permitted Uses
- Commercial use allowed
- Modification and distribution permitted
- Derivative works can be licensed under different terms

### Data Access
- All data in Parquet format
- Available at: https://data.opendevdata.org
- Manifest: https://data.opendevdata.org/manifest.json
- Updated daily with 7-day lag

## Tools & Formats

Compatible with:
- Python (pandas, polars, duckdb)
- R (arrow)
- SQL databases (DuckDB, ClickHouse)
- Data visualization tools (Tableau)

## Important Pages

- Homepage: https://opendevdata.org
- Taxonomy: https://opendevdata.org/taxonomy
- Architecture: https://opendevdata.org/architecture
- Attribution: https://opendevdata.org/attributions
- About: https://opendevdata.org/about
- Tools: https://opendevdata.org/tools

## Contact & Contributions

- Contribute to taxonomy: https://github.com/electric-capital/open-dev-data
- Report issues: GitHub Issues
- Provide feedback: GitHub repository

## Legal

- License: https://data.opendevdata.org/LICENSE.md
- Terms of Service: https://www.electriccapital.com/terms-of-service
- Privacy Policy: https://www.electriccapital.com/privacy

---

Last updated: 2025-11-20