← Back to Downloads

QPCA SDK - Simple Quick Start

Follow these 5 simple steps to run your first quantum computation.

📧 First Step: You need an API key. It's free and takes just a few minutes to get.
Step 1
Get Your API Key

Send an email to get your free API key:

Subject: "API Key Request"

Include: Your name and what you want to use it for (testing, research, etc.)

⏳ You'll receive your API key by email (usually within hours). Check your spam folder if you don't see it.

Step 2
Open Terminal (Command Line)

Mac: Press Cmd + Space, type "Terminal", press Enter

Windows: Press Windows + R, type "cmd", press Enter

💡 Don't worry - you'll just copy and paste commands. No programming knowledge needed!

Step 3
Install the SDK

Copy and paste these commands one at a time (press Enter after each):

python3 -m venv qpca_env source qpca_env/bin/activate

Windows users: Use qpca_env\Scripts\activate instead

pip install qpca-sdk

✅ When you see "Successfully installed", you're done with this step!

Step 4
Set Your API Key

Copy your API key from the email you received, then paste it here:

export QPCA_API_KEY="paste-your-api-key-here"

Windows users: Use set QPCA_API_KEY=paste-your-api-key-here

🔑 Replace "paste-your-api-key-here" with your actual API key from the email.

Step 5
Run Your First Test

First, download the test files from the Downloads page:

  • Click "Download Demo Script"
  • Click "Download Config"

Then run this command (replace the path with where you saved the files):

qpca-cli submit --script /path/to/qpca_benchmark_demo.py --config /path/to/benchmark_config.json

📋 You'll get a "job_id" - copy it! You'll use it to check results.

Check Your Results

Wait a minute, then check if your job is done:

qpca-cli status --job-id YOUR_JOB_ID

When it says "COMPLETED", get your results:

qpca-cli results --job-id YOUR_JOB_ID

🎉 You'll see metrics, download links, and quantum computation results!

Need Help?

Email us at readytogo@quantumpolycontextural.ai

Or see the detailed guide for more information.