crowdcent-challenge 0.1.0__tar.gz

crowdcent_challenge-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,37 @@
+name: ci 
+on:
+  push:
+    branches:
+      - master 
+      - main
+permissions:
+  contents: write
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Configure Git Credentials
+        run: |
+          git config user.name github-actions[bot]
+          git config user.email 41898282+github-actions[bot]@users.noreply.github.com
+      - uses: actions/setup-python@v5
+        with:
+          python-version: 3.x
+      - run: echo "cache_id=$(date --utc '+%V')" >> $GITHUB_ENV 
+      - uses: actions/cache@v4
+        with:
+          key: mkdocs-material-${{ env.cache_id }}
+          path: .cache 
+          restore-keys: |
+            mkdocs-material-
+      - name: Install uv
+        run: |
+          curl -LsSf https://astral.sh/uv/install.sh | sh
+          echo "$HOME/.cargo/bin" >> $GITHUB_PATH
+      - name: Install dependencies
+        run: |
+          uv pip install mkdocs-material mkdocs-click mkdocstrings[python] mkdocs-marimo --system
+          # Install the package itself so CLI docs can be generated
+          uv pip install -e . --system
+      - run: mkdocs gh-deploy --force

crowdcent_challenge-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.ruff_cache
+
+# Data files
+*.csv
+*.parquet

crowdcent_challenge-0.1.0/.python-version

@@ -0,0 +1 @@
+3.12

crowdcent_challenge-0.1.0/CNAME

@@ -0,0 +1 @@
+docs.crowdcent.com

crowdcent_challenge-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 CrowdCent LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE. 

crowdcent_challenge-0.1.0/PKG-INFO

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: crowdcent-challenge
+Version: 0.1.0
+Summary: Crowdcent Challenge Python Client
+Author-email: Jason Rosenfeld <jason@crowdcent.com>
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: click>=8.1.8
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: requests>=2.32.3
+Description-Content-Type: text/markdown
+
+![](https://img.shields.io/pypi/v/crowdcent-challenge.png)
+![Python Version](https://img.shields.io/badge/dynamic/toml?url=https://raw.githubusercontent.com/crowdcent/crowdcent-challenge/master/pyproject.toml&query=%24.project%5B%22requires-python%22%5D&label=python&color=blue)
+![](https://img.shields.io/github/contributors/crowdcent/crowdcent-challenge.png)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+![](https://img.shields.io/codecov/c/gh/crowdcent/crowdcent-challenge/master)
+![](https://img.shields.io/pypi/dm/crowdcent-challenge)
+
+# CrowdCent Challenge
+The CrowdCent Challenge is an open data science competition. This documentation is currently being updated. Please check back soon for detailed information about the challenge rules and format.
+
+**Documentation**: [docs.crowdcent.com](https://docs.crowdcent.com)
+
+
+## Have Questions?
+If you need immediate assistance, please email us at info@crowdcent.com or join our [Discord server](https://discord.gg/crowdcent).

crowdcent_challenge-0.1.0/README.md

@@ -0,0 +1,16 @@
+![](https://img.shields.io/pypi/v/crowdcent-challenge.png)
+![Python Version](https://img.shields.io/badge/dynamic/toml?url=https://raw.githubusercontent.com/crowdcent/crowdcent-challenge/master/pyproject.toml&query=%24.project%5B%22requires-python%22%5D&label=python&color=blue)
+![](https://img.shields.io/github/contributors/crowdcent/crowdcent-challenge.png)
+[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
+![](https://img.shields.io/codecov/c/gh/crowdcent/crowdcent-challenge/master)
+![](https://img.shields.io/pypi/dm/crowdcent-challenge)
+
+# CrowdCent Challenge
+The CrowdCent Challenge is an open data science competition. This documentation is currently being updated. Please check back soon for detailed information about the challenge rules and format.
+
+**Documentation**: [docs.crowdcent.com](https://docs.crowdcent.com)
+
+
+## Have Questions?
+If you need immediate assistance, please email us at info@crowdcent.com or join our [Discord server](https://discord.gg/crowdcent).

crowdcent_challenge-0.1.0/docs/CNAME

@@ -0,0 +1 @@
+docs.crowdcent.com

crowdcent_challenge-0.1.0/docs/about.md

@@ -0,0 +1,5 @@
+# About 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.
+
+More information about CrowdCent can be found on [crowdcent.com](https://crowdcent.com). 

crowdcent_challenge-0.1.0/docs/changelog.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.1.0 (2025-04-15)
+
+*   Initial release.
+*   Added `ChallengeClient` with methods for datasets and submissions.
+*   Added CLI interface (`crowdcent-challenge`).
+*   Added basic documentation with MkDocs. 

crowdcent_challenge-0.1.0/docs/cli.md

@@ -0,0 +1,142 @@
+# Command Line Interface (CLI) Usage
+
+The package provides a command-line interface (CLI) called `crowdcent` for quick interactions with the API.
+
+## Authentication
+
+The CLI requires your API key for authentication. It looks for the key in the following order:
+
+1.  The `CROWDCENT_API_KEY` environment variable.
+2.  A `.env` file in the current working directory containing `CROWDCENT_API_KEY=your_key_here`.
+
+If the key is not found, the CLI commands will fail with an authentication error.
+
+## General Usage
+
+```bash
+crowdcent [OPTIONS] COMMAND [ARGS]...
+```
+
+Get help on the main command or subcommands:
+
+```bash
+crowdcent --help
+crowdcent list-challenges --help
+crowdcent submit --help
+```
+
+## Commands
+
+### Challenges
+
+* List active challenges:
+    ```bash
+    crowdcent list-challenges
+    ```
+    Output is JSON formatted.
+
+* Get specific challenge details:
+    ```bash
+    crowdcent get-challenge <CHALLENGE_SLUG>
+    ```
+    Replace `<CHALLENGE_SLUG>` with the actual challenge slug (e.g., `crowdcent get-challenge stock-prediction`). Output is JSON formatted.
+
+### Training Data
+
+* List training datasets for a challenge:
+    ```bash
+    crowdcent list-training-data <CHALLENGE_SLUG>
+    ```
+    Output is JSON formatted.
+
+* Get the latest training dataset for a challenge:
+    ```bash
+    crowdcent get-latest-training-data <CHALLENGE_SLUG>
+    ```
+    Output is JSON formatted.
+
+* Get specific training dataset details:
+    ```bash
+    crowdcent get-training-data <CHALLENGE_SLUG> <VERSION>
+    ```
+    Replace `<CHALLENGE_SLUG>` with the challenge slug and `<VERSION>` with the version string (e.g., `1.0`). Output is JSON formatted.
+
+* Download training dataset file:
+    ```bash
+    crowdcent download-training-data <CHALLENGE_SLUG> <VERSION> [-o <OUTPUT_PATH>]
+    ```
+    -   Replace `<CHALLENGE_SLUG>` with the challenge slug.
+    -   Replace `<VERSION>` with the version string or `latest` for the latest version.
+    -   The `-o` or `--output` flag is optional. If omitted, the file is saved as `<CHALLENGE_SLUG>_training_v<VERSION>.parquet` in the current directory.
+    
+    Example:
+    ```bash
+    crowdcent download-training-data stock-prediction 1.0 -o data/training_data.parquet
+    ```
+
+### Inference Data
+
+* List inference data periods for a challenge:
+    ```bash
+    crowdcent list-inference-data <CHALLENGE_SLUG>
+    ```
+    Output is JSON formatted.
+
+* Get the current inference data period for a challenge:
+    ```bash
+    crowdcent get-current-inference-data <CHALLENGE_SLUG>
+    ```
+    Output is JSON formatted.
+
+* Get specific inference data period details:
+    ```bash
+    crowdcent get-inference-data <CHALLENGE_SLUG> <RELEASE_DATE>
+    ```
+    Replace `<CHALLENGE_SLUG>` with the challenge slug and `<RELEASE_DATE>` with the date in `YYYY-MM-DD` format. Output is JSON formatted.
+
+* Download inference features file:
+    ```bash
+    crowdcent download-inference-data <CHALLENGE_SLUG> <RELEASE_DATE> [-o <OUTPUT_PATH>]
+    ```
+    -   Replace `<CHALLENGE_SLUG>` with the challenge slug.
+    -   Replace `<RELEASE_DATE>` with the date in `YYYY-MM-DD` format or `current` for the current period.
+    -   The `-o` or `--output` flag is optional. If omitted, the file is saved as `<CHALLENGE_SLUG>_inference_<RELEASE_DATE>.parquet` in the current directory.
+    
+    Example:
+    ```bash
+    crowdcent download-inference-data stock-prediction 2025-01-15 -o data/inference_features.parquet
+    ```
+
+### Submissions
+
+* List your submissions for a challenge:
+    ```bash
+    crowdcent list-submissions <CHALLENGE_SLUG> [--period <PERIOD>]
+    ```
+    -   Replace `<CHALLENGE_SLUG>` with the challenge slug.
+    -   The `--period` flag is optional. It can be set to `current` for the current period or a date in `YYYY-MM-DD` format to filter by period.
+    
+    Output is JSON formatted.
+
+* Get specific submission details:
+    ```bash
+    crowdcent get-submission <CHALLENGE_SLUG> <SUBMISSION_ID>
+    ```
+    Replace `<CHALLENGE_SLUG>` with the challenge slug and `<SUBMISSION_ID>` with the actual ID. Output is JSON formatted.
+
+* Submit predictions:
+    ```bash
+    crowdcent submit <CHALLENGE_SLUG> <PATH_TO_PREDICTIONS_PARQUET>
+    ```
+    Replace `<CHALLENGE_SLUG>` with the challenge slug and `<PATH_TO_PREDICTIONS_PARQUET>` with the path to your prediction file.
+    
+    The file must be a valid Parquet file with the required columns: `id`, `pred_1M`, `pred_3M`, `pred_6M`, `pred_9M`, and `pred_12M`.
+    
+    Example:
+    ```bash
+    crowdcent submit stock-prediction results/my_submission.parquet
+    ```
+
+## Error Handling
+
+The CLI will print error messages to standard error if an API call fails or if invalid arguments are provided. 

crowdcent_challenge-0.1.0/docs/cli_reference.md

@@ -0,0 +1,9 @@
+# CLI Reference
+
+This page provides auto-generated documentation for the `crowdcent` CLI for the CrowdCent Challenge.
+
+::: mkdocs-click
+    :module: crowdcent_challenge.cli
+    :command: cli
+    :prog_name: crowdcent
+    :depth: 1

crowdcent_challenge-0.1.0/docs/contributing.md

@@ -0,0 +1,27 @@
+# Contributing
+Contributions are welcome! The `crowdcent-challenge` API client and documentation are open-source projects and contributions can be as simple as a fact check or as complex as a new feature.
+
+Here's a breakdown of the standard GitHub workflow:
+
+1. Fork the [repository](https://github.com/crowdcent/crowdcent-challenge)
+2. Clone your fork:
+   ```bash
+   git clone https://github.com/<your-username>/crowdcent-challenge.git
+   cd crowdcent-challenge
+   uv pip install -e .[dev]
+   ```
+3. Branch off:
+   ```bash
+   git checkout -b my-feature
+   ```
+4. Make changes & test
+5. Commit with clear messages:
+   ```bash
+   git commit -m "feat: Add new feature"
+   ```
+6. Push & open a PR from your fork
+    ```bash
+    git push origin my-feature
+    ```
+
+Include tests where appropriate. Keep PRs focused - one feature/fix per PR.

crowdcent_challenge-0.1.0/docs/data.md

@@ -0,0 +1,115 @@
+# Data
+
+## Data Structure
+
+The CrowdCent Challenge platform organizes data into the following hierarchy:
+
+1. **Challenges** - The top-level competitions (e.g., "Stock Price Prediction Challenge")
+2. **Training Datasets** - Versioned datasets used for training your models
+3. **Inference Data** - Periodic releases of new data for making predictions
+4. **Submissions** - Your predictions for inference data periods
+
+### Challenge Data
+
+Each challenge focuses on a specific prediction task. A challenge has:
+
+- A unique slug (identifier in URLs)
+- A name and description
+- Start and end dates
+- Associated training datasets and inference periods
+
+### Training Datasets
+
+Training datasets provide labeled data for building your models. Each training dataset has:
+
+- A version (e.g., "1.0", "2.1")
+- Feature and target descriptions
+- A Parquet file containing training data with features and ground truth labels
+
+Training datasets may be updated with new versions over time, but only one version is marked as "latest" at any time.
+
+### Inference Data
+
+Inference data represents periodic releases of new data for which you will make predictions. Each inference data period has:
+
+- A release date
+- A submission deadline
+- A Parquet file containing features (but not targets) for inference
+
+## Data Features and Format
+
+All data is provided in Parquet format, a columnar storage file format optimized for analytical processing.
+
+### Dataset Components
+
+#### Identifier (`id`)
+- A unique numerical identifier assigned to each investment idea submission
+- This `id` is obfuscated and does not directly reveal the underlying security or analyst
+
+#### Features
+The features are derived from the content and context of the investment idea submission:
+
+**NLP Features**
+- Generated by processing the analyst's investment write-up text
+- Include embeddings related to different aspects discussed in the write-up (e.g., catalysts, financials, management)
+- Named like `nlp_groupname_N` (e.g., `nlp_catalyst_0`, `nlp_financials_15`)
+- Contain numerical values representing elements of the embedding vectors
+
+**Point-in-Time Features**
+- Based on market conditions, fundamental data, or other factors known *at the time the idea was submitted*
+- Obfuscated and named like `fundamental_N`, `market_N`, `categorical_N`, etc.
+- Contain numerical values
+
+#### Prediction Target
+Your goal is to predict return values for different time horizons. For each inference data point, you must submit predictions for the following time horizons:
+
+- `pred_1M`: Predicted return after 1 month
+- `pred_3M`: Predicted return after 3 months
+- `pred_6M`: Predicted return after 6 months
+- `pred_9M`: Predicted return after 9 months
+- `pred_12M`: Predicted return after 12 months
+
+## Submission Format
+
+Submissions must be Parquet files with the following columns:
+
+| Column | Description |
+|--------|-------------|
+| `id` | Unique identifier matching the inference data |
+| `pred_1M` | Predicted 1-month return |
+| `pred_3M` | Predicted 3-month return |
+| `pred_6M` | Predicted 6-month return |
+| `pred_9M` | Predicted 9-month return |
+| `pred_12M` | Predicted 12-month return |
+
+All prediction columns must contain numeric values (float or integer). Missing values are not allowed.
+
+## Example Data Snippet
+
+The following table shows a small, purely illustrative example of what a few rows of the data might look like. The column names follow the conventions described above, but the values are entirely fictional and intended only to demonstrate the format. The actual number of features and their ranges will vary.
+
+### Example Training Data:
+
+|   id | nlp_catalyst_0 | nlp_catalyst_1 | fundamental_0 | market_0 | market_1 | categorical_0 | target_1M | target_3M | target_6M | target_9M | target_12M |
+| ---: | -------------: | -------------: | ------------: | -------: | -------: | ------------: | --------: | --------: | --------: | --------: | ---------: |
+| 1001 |       0.123456 |      -0.987654 |     12.340000 |   105.50 |   250000 |             1 |      0.05 |      0.12 |      0.18 |      0.22 |       0.25 |
+| 1002 |      -0.543210 |       0.010101 |      0.987000 |    32.15 |  1500000 |             3 |     -0.02 |     -0.08 |     -0.15 |     -0.10 |      -0.05 |
+| 1003 |       0.678901 |       1.234567 |     -5.670000 |   210.75 |   750000 |             1 |      0.10 |      0.25 |      0.40 |      0.45 |       0.50 |
+| 1004 |       0.314159 |      -0.271828 |     55.432100 |    88.90 |   120000 |             2 |      0.07 |      0.14 |      0.20 |      0.18 |       0.15 |
+
+### Example Inference Data (for prediction):
+
+|   id | nlp_catalyst_0 | nlp_catalyst_1 | fundamental_0 | market_0 | market_1 | categorical_0 |
+| ---: | -------------: | -------------: | ------------: | -------: | -------: | ------------: |
+| 2001 |       0.234567 |      -0.876543 |     15.430000 |   110.25 |   275000 |             2 |
+| 2002 |      -0.432109 |       0.121212 |      1.876000 |    29.75 |  1300000 |             3 |
+| 2003 |       0.567890 |       0.987654 |     -4.560000 |   205.50 |   800000 |             1 |
+
+### Example Submission (your predictions):
+
+|   id | pred_1M | pred_3M | pred_6M | pred_9M | pred_12M |
+| ---: | ------: | ------: | ------: | ------: | -------: |
+| 2001 |    0.06 |    0.14 |    0.19 |    0.23 |     0.27 |
+| 2002 |   -0.01 |   -0.07 |   -0.13 |   -0.09 |    -0.03 |
+| 2003 |    0.11 |    0.27 |    0.42 |    0.48 |     0.53 |
+

crowdcent_challenge-0.1.0/docs/disclaimer.md

@@ -0,0 +1,2 @@
+# Disclaimer
+Under no circumstances should any information provided in this software — or on associated distribution outlets — be construed as an offer soliciting the purchase or sale of any security or interest in any pooled investment vehicle sponsored, discussed, or mentioned by CrowdCent LLC or affiliates. Nor should it be construed as an offer to provide investment advisory services; an offer to invest in a CrowdCent investment vehicle will be made separately and only by means of the confidential offering documents of the specific pooled investment vehicles — which should be read in their entirety, and only to those who, among other requirements, meet certain qualifications under federal securities laws. Such investors, defined as accredited investors and qualified purchasers, are generally deemed capable of evaluating the merits and risks of prospective investments and financial matters. There can be no assurances that CrowdCent's investment objectives will be achieved or investment strategies will be successful. Any investment in a vehicle managed by CrowdCent involves a high degree of risk including the risk that the entire amount invested is lost. Any investments or portfolio companies mentioned, referred to, or described are not representative of all investments in vehicles managed by CrowdCent and there can be no assurance that the investments will be profitable or that other investments made in the future will have similar characteristics or results.

crowdcent_challenge-0.1.0/docs/examples.md

@@ -0,0 +1,176 @@
+# Interactive Examples
+
+## Fetching Challenges and Inference Data
+
+This example demonstrates how to use the `ChallengeClient` to fetch available challenges and get details about the current inference data period. You can optionally provide your API key below, or leave it blank if you have the `CROWDCENT_API_KEY` environment variable or a `.env` file configured.
+
+/// marimo-embed
+    height: 750px
+    mode: edit
+    app_width: full
+
+```python
+@app.cell(hide_code=True)
+def _(mo):
+    mo.md(r"""## Challenge Information""")
+    return
+
+# Cell 1: Input for API Key (optional)
+@app.cell
+def __():
+    import marimo as mo
+    api_key_input = mo.ui.text(
+        placeholder="Leave blank to use env/dotenv",
+        label="API Key (Optional)",
+        kind="password",
+    )
+    # Display the input field
+    api_key_input
+    # Return it so other cells can use its value
+    return api_key_input, mo
+
+# Cell 2: Fetch and display challenges
+@app.cell
+def __(api_key_input, mo):
+    from crowdcent_challenge import ChallengeClient, CrowdcentAPIError, AuthenticationError
+    
+    # Initialize placeholder text
+    challenge_info = mo.md("Enter your API key above and click 'List Challenges' to begin.")
+    
+    # Create button for listing challenges
+    list_challenges_button = mo.ui.button(label="List Challenges")
+    
+    # React to the button click (its value increments each time)
+    if list_challenges_button.value > 0:
+        # Get API key from input if provided, else None
+        api_key = api_key_input.value or None
+        try:
+            # Initialize client
+            client = ChallengeClient(api_key=api_key)
+            challenges = client.list_challenges()
+            
+            if not challenges:
+                challenge_info = mo.md("No active challenges found.")
+            else:
+                # Create a dropdown to select a challenge
+                challenge_options = {c['name']: c['slug'] for c in challenges}
+                challenge_dropdown = mo.ui.dropdown(
+                    options=challenge_options,
+                    label="Select a Challenge",
+                    value=list(challenge_options.values())[0] if challenge_options else None
+                )
+                
+                challenge_info = mo.vstack([
+                    mo.md(f"**Found {len(challenges)} active challenges:**"),
+                    challenge_dropdown
+                ])
+        except AuthenticationError:
+            challenge_info = mo.md(
+                f"""
+                **Authentication Error!**
+
+                Please ensure your `CROWDCENT_API_KEY` is set correctly
+                in your environment or a `.env` file, or enter it above.
+                """
+            )
+        except CrowdcentAPIError as e:
+             challenge_info = mo.md(f"**API Error:** `{e}`")
+        except Exception as e:
+             challenge_info = mo.md(f"**Unexpected Error:** `{e}`")
+    
+    # Display the button and results
+    mo.vstack([list_challenges_button, challenge_info])
+    
+    # Return values for the next cell
+    return mo, AuthenticationError, ChallengeClient, CrowdcentAPIError, list_challenges_button
+
+# Cell 3: Get information about selected challenge
+@app.cell
+def __(mo, api_key_input, list_challenges_button, AuthenticationError, ChallengeClient, CrowdcentAPIError):
+    # Initialize placeholder for challenge details
+    challenge_details = mo.md("Select a challenge above to view details.")
+    
+    # Only proceed if challenges have been loaded
+    if list_challenges_button.value > 0 and "_5" in globals():
+        challenge_dropdown = globals()["_5"].get("challenge_dropdown")
+        
+        if challenge_dropdown and challenge_dropdown.value:
+            get_details_button = mo.ui.button(label="Get Challenge Details")
+            
+            if get_details_button.value > 0:
+                # Get API key from input if provided, else None
+                api_key = api_key_input.value or None
+                try:
+                    # Initialize client
+                    client = ChallengeClient(api_key=api_key)
+                    selected_slug = challenge_dropdown.value
+                    
+                    # Fetch challenge details
+                    challenge = client.get_challenge(selected_slug)
+                    
+                    # Try to get current inference period
+                    try:
+                        current_period = client.get_current_inference_data(selected_slug)
+                        period_info = f"""
+                        **Current Inference Period:**
+                        * Release Date: {current_period.get('release_date', 'N/A')}
+                        * Submission Deadline: {current_period.get('submission_deadline', 'N/A')}
+                        * Time Remaining: {current_period.get('time_remaining', 'N/A')}
+                        """
+                    except Exception as e:
+                        period_info = f"""
+                        **No Active Inference Period**
+                        {str(e)}
+                        """
+                    
+                    # Try to get latest training data
+                    try:
+                        latest_training = client.get_latest_training_dataset(selected_slug)
+                        training_info = f"""
+                        **Latest Training Dataset:**
+                        * Version: {latest_training.get('version', 'N/A')}
+                        * Upload Date: {latest_training.get('uploaded_at', 'N/A')}
+                        """
+                    except Exception as e:
+                        training_info = f"""
+                        **No Training Datasets Available**
+                        {str(e)}
+                        """
+                    
+                    challenge_details = mo.md(
+                        f"""
+                        ## {challenge.get('name', 'Unknown Challenge')}
+                        
+                        **Slug:** `{selected_slug}`
+                        
+                        **Description:** {challenge.get('description', 'No description available.')}
+                        
+                        **Status:** {'Active' if challenge.get('is_active', False) else 'Inactive'}
+                        
+                        **Dates:** {challenge.get('start_date', 'N/A')} to {challenge.get('end_date', 'N/A')}
+                        
+                        {period_info}
+                        
+                        {training_info}
+                        """
+                    )
+                except AuthenticationError:
+                    challenge_details = mo.md("**Authentication Error!** Please check your API key.")
+                except CrowdcentAPIError as e:
+                    challenge_details = mo.md(f"**API Error:** `{e}`")
+                except Exception as e:
+                    challenge_details = mo.md(f"**Unexpected Error:** `{e}`")
+            
+            result = mo.vstack([get_details_button, challenge_details])
+        else:
+            result = challenge_details
+    else:
+        result = challenge_details
+    
+    # Display the result
+    result
+    return result
+
+```
+
+///

crowdcent_challenge-0.1.0/docs/index.md

@@ -0,0 +1,44 @@
+# CrowdCent Challenge
+Welcome to the documentation for the `crowdcent-challenge`. Please check back soon for detailed information about the challenge rules and format.
+
+Anyone can submit to this documentation or improve the python client and CLI for the `crowdcent-challenge` API. Please see the [contributing guidelines](contributing.md) for more information.
+
+Explore the rules, understand the scoring, get started with the python client, or dive into the API reference.
+
+<div class="grid cards" markdown>
+
+-   :material-scale-balance:{ .lg .middle } Challenge Rules
+
+    ---
+
+    Understand the official rules and guidelines for participating in the CrowdCent Challenge.
+
+    [:octicons-arrow-right-24: Read the Rules](rules.md)
+
+-   :material-scoreboard:{ .lg .middle } Scoring System
+
+    ---
+
+    Learn how submissions are evaluated and how the leaderboard rankings work.
+
+    [:octicons-arrow-right-24: View Scoring Details](scoring.md)
+
+-   :material-language-python:{ .lg .middle } Python Client
+
+    ---
+
+    Install the client library and make your first submission quickly.
+
+    [:octicons-arrow-right-24: Quick Start Guide](quickstart.md)
+
+-   :material-api:{ .lg .middle } API Reference
+
+    ---
+
+    Detailed reference for the Python client and the command-line interface.
+
+    [:octicons-arrow-right-24: Explore the API](python_reference.md)
+
+</div>
+## Have Questions?
+If you need immediate assistance, please email us at info@crowdcent.com or join our [Discord server](https://discord.gg/v6ZSGuTbQS).