pip install miura-epico
```python [python]

### From Source
```bash [bash]
git clone https://gitlab.com/wabisabi1/applications/epico.git
cd epico
poetry install
```python [python]

## Quick Start

### Authentication

The Nexus API uses token-based authentication. Set your API key using one of these methods:

**Option 1: Environment Variable (Recommended for Services)**
```bash [bash]
export MIURA_NEXUS_API_KEY="your-api-key-here"
```bash [bash]

**Option 2: CLI Storage (Recommended for Interactive Use)**

# Set your authentication token
miura-auth token set --token "your-api-key-here"

# Verify token is stored
miura-auth token status

### Basic Usage

```python [python]
import asyncio
from miura.aio import AsyncNexus
from miura.logging import get_logger

logger = get_logger(__name__)

async def main():
    async with AsyncNexus() as nexus:
        # List projects
        projects = await nexus.list_projects()
        logger.info(f"Found {len(projects)} project(s)")
        

        # Create a project
        project = await nexus.create_project("my-project")
        logger.info(f"Created project: {project.name}")
        

        # Create a collection with schema
        collection = await project.create_collection(
            collection_name="my-collection",
            schema=[{"pattern": ".*\\.vtk$", "min_occurrence": 1}]
        )
        logger.info(f"Created collection: {collection.name}")

asyncio.run(main())

## Documentation Structure

### Getting Started
- **[Getting Started Guide](/docs/v0.5.0/getting-started)** - Start here! Get up and running quickly with authentication, configuration, and basic usage examples.

### Progressive Tutorials

These tutorials are designed to be followed in order, each building on the previous one:

1. **[Projects and Collections](/docs/v0.5.0/projects-and-collections)** - Create and manage projects and collections using different navigation styles
2. **[Schemas](/docs/v0.5.0/schemas)** - Understand schemas as quality gates and automatically generate them from your data structure
3. **[Uploading Data](/docs/v0.5.0/uploading-data)** - Upload data to collections with automatic schema validation
4. **[Fetching Data](/docs/v0.5.0/fetching-data)** - List, iterate, retrieve, and download collection items
5. **[End-to-End Workflows](/docs/v0.5.0/end-to-end-workflows)** - Complete, real-world workflows combining all features

## Key Concepts

### Navigation Styles

The API supports two navigation styles, both equally supported:

- **Object-Oriented**: `nexus.get_project()` → `project.get_collection()` → `collection.get_item()`
- **Path-Based**: `nexus.get("project/collection/item")`

### Schemas as Quality Gates

**Schemas are quality gates for data ingestion.** They ensure:
- Only properly structured data enters your collection
- Data consistency across all uploads
- Early detection of problems (during prevalidation)
- Clear documentation of expected data structure

### Async vs Sync

- **Async API** (`miura.aio`): Primary interface, use for new code
- **Sync API** (`miura`): Compatibility layer for synchronous code or Jupyter notebooks

:::tip
New to the Nexus platform? Start with our [Getting Started guide](/docs/v0.5.0/getting-started) to learn the fundamentals before diving into advanced features.
:::