> ## Documentation Index
> Fetch the complete documentation index at: https://docs.alshival.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Ship your first DevTools integration with Python, Node.js, or curl

## Prerequisites

* DevTools account with an active API key
* A target Resource URL copied from the DevTools Resource Details page (works for owned and shared resources)
* One of:
  * Python 3.9+
  * Node.js 18+
  * `curl`

## Step 1: set environment variables

```bash theme={null}
export ALSHIVAL_USERNAME='your_username'
export ALSHIVAL_API_KEY='your_api_key'
export ALSHIVAL_RESOURCE='https://alshival.dev/u/resource_owner_username/resources/resource_uuid/' # paste Resource URL from DevTools Resource Details
export ALSHIVAL_CLOUD_LEVEL='INFO'
```

`ALSHIVAL_USERNAME` is always your identity. `ALSHIVAL_RESOURCE` can point to your own resource or one shared with you.

## Step 2: send your first log

<Tabs>
  <Tab title="Python SDK">
    ```bash theme={null}
    pip install git+https://github.com/Alshival-Ai/alshival.git@main
    ```

    ```python theme={null}
    import alshival

    alshival.log.info('service started')
    alshival.log.alert('payment queue delay detected', extra={'queue': 'payments'})
    ```
  </Tab>

  <Tab title="Node.js SDK">
    ```bash theme={null}
    npm install @alshival.ai/alshival
    ```

    ```javascript theme={null}
    const alshival = require('@alshival.ai/alshival');

    alshival.log.info('service started');
    alshival.log.alert('payment queue delay detected', { extra: { queue: 'payments' } });
    ```
  </Tab>

  <Tab title="curl">
    ```bash theme={null}
    curl -X POST \
      -H "Content-Type: application/json" \
      -H "X-API-Key: $ALSHIVAL_API_KEY" \
      -d '{
        "logs": [
          {
            "level": "info",
            "message": "service started",
            "ts": "2026-02-22T00:00:00+00:00"
          }
        ]
      }' \
      "${ALSHIVAL_RESOURCE%/}/logs/"
    ```
  </Tab>
</Tabs>

## Step 3: connect MCP tools

For OpenAI Responses-compatible tool descriptors:

* Python: use `alshival.mcp` and `alshival.mcp.github`
* Node.js: use `alshival.mcp` and `alshival.mcp.github`

See `/sdk/python` and `/sdk/nodejs` for full examples.