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

# JavaScript Installation

> Get our SDK up and running in your Javascript environment

### Requirements

As best practice, it is recommended to set up your environment variables. Create a `.env` file in your project root and add the following:

```bash theme={null}
VALENCE_API_KEY=your_api_key                    # Required: Your Valence API key
VALENCE_DISCRETE_URL=https://discrete-api-url   # Optional: Discrete audio endpoint
VALENCE_ASYNCH_URL=https://asynch-api-url        # Optional: Asynch audio endpoint  
VALENCE_LOG_LEVEL=info                          # Optional: debug, info, warn, error
```

Your Valence API Key is required, while while all other fields are optional.

### Usage

Install the package via `npm`.

```bash theme={null}
npm install valenceai
```

You can validate the package configuration using the following code:

```javascript theme={null}
import { validateConfig } from 'valenceai';

try {
  validateConfig();
  console.log('Configuration is valid!');
} catch (error) {
  console.error('Configuration error:', error.message);
}
```

**Client Constructor:**

```javascript theme={null}
import { ValenceClient } from 'valenceai';

client = new ValenceClient(
    None,           // API key (or use VALENCE_API_KEY env var)
    5*1024*1024,    // Size of each upload chunk for asynch audio
    5              // Number of retry attempts
)
```

**DiscreteAPI:**

```javascript theme={null}
import { ValenceClient } from 'valenceai';

try {
  const client = new ValenceClient();
  const result = await client.discrete.emotions('YOUR_FILE.wav');
  console.log('Emotion detected:', result);
} catch (error) {
  console.error('Error:', error.message);
}
```

**AsynchAPI:**

```javascript theme={null}
import { ValenceClient } from 'valenceai';

try {
  const client = new ValenceClient();
  
  // Upload the audio file
  const requestId = await client.asynch.upload('YOUR_FILE.wav');
  console.log('Upload complete. Request ID:', requestId);
  
  // Get emotions from uploaded audio
  const emotions = await client.asynch.emotions(requestId);
  console.log('Emotions detected:', emotions);
} catch (error) {
  console.error('Error:', error.message);
}
```

**Advanced AsynchAPI Usage:**

This usage is only recommended if you receive errors during file uploads or require smaller upload segments during the upload of a large file.

```javascript theme={null}
import { ValenceClient } from 'valenceai';

// Custom client configuration
const client = new ValenceClient(
  2 * 1024 * 1024,  // 2MB parts
  5                  // 5 retry attempts
);

// Upload with custom configuration
const requestId = await client.asynch.upload('huge_file.wav');

// Custom polling with more attempts and shorter intervals
const emotions = await client.asynch.emotions(
  requestId,
  50,    // 50 polling attempts
  3      // 3 second intervals
);
```

More information about additional parameters and expected values can be found in the [API Reference](/api-reference/introduction).

<Card title="Ready to Get Started?" icon="rectangle-code" href="https://www.npmjs.com/package/valenceai">
  Check out the Valence package on NPM →
</Card>