Skip to main content
CrowdCent Logo

CrowdCent Challenge

Open data science competitions for ML engineers and data scientists

PyPI Python License Downloads Discord Docs


Get Started View Challenges


The CrowdCent Challenge is an open data science competition designed for machine learning engineers, data scientists, AI agents, and other technical professionals to hone their skills in a real-world setting.

What is CrowdCent?

CrowdCent is on a mission to decentralize investment management by changing the way investment funds make decisions and allocate capital. We are the machine learning and coordination layer for online investment communities looking to turn their data into actionable, investable portfolios.

Installation

uv pip

uv add crowdcent-challenge

Using pip

pip install crowdcent-challenge

Quick Start

  1. Get an API Key: Generate your key from your profile settings
  2. Set up authentication:
    export CROWDCENT_API_KEY=your_api_key_here
    # or create a .env file with: CROWDCENT_API_KEY=your_api_key_here
    
  3. Start competing:
    from crowdcent_challenge import ChallengeClient
    
    # Initialize client for a challenge
    client = ChallengeClient(challenge_slug="hyperliquid-ranking")
    
    # Download training data
    client.download_training_dataset("latest", "training_data.parquet")
    
    # Download inference data
    client.download_inference_data("current", "inference_data.parquet")
    
    # Submit predictions, from a parquet or a CSV file
    client.submit_predictions(file_path="predictions.parquet")
    
    # Every file comes and goes as CSV too: just name the path .csv
    client.download_inference_data("current", "inference_data.csv")
    client.submit_predictions(file_path="predictions.csv")
    
    # Or test a new model with an experimental submission + private note
    # (requires another slot to have a non-experimental submission)
    client.submit_predictions(
        file_path="predictions.parquet",
        slot=2,
        is_experimental=True,
        notes="2-layer transformer w/ sector embeddings",
    )
    

Available Challenges

  • Hyperliquid Ranking: Rank crypto assets on Hyperliquid by expected relative returns Hyperliquid Challenge

  • Equity NLP: Coming soon! Equity NLP

CLI Usage

The package includes a command-line interface:

# List all challenges
crowdcent list-challenges

# Set default challenge
crowdcent set-default-challenge hyperliquid-ranking

# Download data
crowdcent download-training-data latest -o training.parquet
crowdcent download-inference-data current -o inference.parquet

# Submit predictions
crowdcent submit predictions.parquet

# Submit an experimental prediction with a private note
crowdcent submit predictions.parquet --slot 2 --experimental \
    --notes "2-layer transformer w/ sector embeddings"

# Scores, and what your API key may do
crowdcent performance
crowdcent whoami

# Backtest the meta-model
crowdcent sim run --config '{"n_long": 10, "n_short": 10, "rebalance_days": "10t"}'

# Live trading: preview, then execute the plan (testnet unless --network mainnet)
crowdcent trade preview
crowdcent trade execute PLAN_HASH

# CrowdCent Cloud: create, run, and schedule a project
crowdcent cloud create "My model" --recipe hyperliquid-ranking --challenge-access
crowdcent cloud run PROJECT_ID --wait
crowdcent cloud schedule PROJECT_ID --trigger on_inference_release --release-challenge hyperliquid-ranking

Every command prints JSON; run crowdcent <command> --help for its options.

Documentation: docs.crowdcent.com

AI Agents / MCP Server

This package ships with a built-in Model Context Protocol (MCP) server, so assistants like Claude and Cursor can download data, submit predictions, backtest strategies on the meta-model, and check your performance in natural language. Connect the hosted server at https://mcp.crowdcent.com/mcp with your API key, or run it locally with one line:

{"mcpServers": {"crowdcent": {
  "command": "uvx",
  "args": ["--from", "crowdcent-challenge[mcp]", "crowdcent-mcp"],
  "env": {"CROWDCENT_API_KEY": "your_api_key_here"}
}}}

See the AI Agents guide for hosted setup, the simulation tools, and live trading.

Contributing

Contributions are welcome! The crowdcent-challenge client library and documentation are open source.

See our contributing guidelines for details on:

  • Forking and cloning the repository
  • Setting up development environment
  • Making changes and submitting PRs

Have Questions?

Documentation Discord Email

Metadata

Release files for crowdcent-challenge 0.2.19

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for crowdcent-challenge 0.2.19
File Size Uploaded Provenance Actions
crowdcent_challenge-0.2.19.tar.gz 668.5 kB Without provenance Details for crowdcent_challenge-0.2.19.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for crowdcent-challenge 0.2.19
File Interpreter ABI Platform Actions
crowdcent_challenge-0.2.19-py3-none-any.whl Python 3 none any Details for crowdcent_challenge-0.2.19-py3-none-any.whl

Total release size: 746.4 kB

Release files / crowdcent_challenge-0.2.19.tar.gz

Download URL crowdcent_challenge-0.2.19.tar.gz
Size 668.5 kB
Tags Source
SHA-256 checksum
How to use checksums
2d626317cc6e109c4103b39241188a1768d0f36e28213b2b756ead040d1a104d
BLAKE2b-256 checksum
How to use checksums
f0b076273a2b32256edf7c945743c4f37a5259fc64256fb64fcc2595cf328874
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.13

Release files / crowdcent_challenge-0.2.19-py3-none-any.whl

Download URL crowdcent_challenge-0.2.19-py3-none-any.whl
Size 78.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
de449f1d4d02e5f3672f48d35146543aad979c7a6f5c0f9e12881ce916a945ba
BLAKE2b-256 checksum
How to use checksums
c45b1b885cca95045e227566fed8cdeea70debdabb77407b4475510a852bf96a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.7.13

Security for crowdcent-challenge 0.2.19

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.19 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page