​

Login via GitHub

Rastion uses GitHub authentication to provide seamless access to the platform. Simply sign in with your GitHub account to get started with optimization tools and repositories.

​

Why GitHub Authentication?

• Seamless Integration: Use your existing GitHub identity
• Secure Access: OAuth-based authentication with GitHub
• Repository Sync: Easy integration with your existing repositories
• Community Features: Connect with other developers in the optimization community

​

Sign In Process

​

1. Visit Rastion Platform

Go to rastion.com and click the “Login with GitHub” button.

​

2. Authorize with GitHub

You’ll be redirected to GitHub where you’ll be asked to authorize Rastion to access:

• Your public profile information (username, email, full name)
• Your public repositories (for easy repository management)

​

3. Complete Registration

After authorization, you’ll be redirected back to Rastion where:

• Your account is automatically created
• Your profile is populated with GitHub information
• You gain access to all platform features

​

Getting Your API Token

​

Access Settings

Once logged in:

1. Navigate to Settings: Click on your profile → Settings

2. Find API Section: Look for “Rastion API Token” or “API Access”

3. Generate Token: Click “Generate New Token” if you don’t have one
4. Copy Token: Save your token securely - you’ll need it for uploads

​

Token Usage

Your Rastion API token (which is actually a Gitea token behind the scenes) allows you to:

import qubots.rastion as rastion

# Authenticate with your token
rastion.authenticate("your_rastion_api_token_here")

# Now you can upload repositories, run optimizations, etc.

​

What You Get Access To

​

Platform Features

With GitHub authentication, you get full access to:

• Repository Management: Upload and manage optimization repositories
• Playground Access: Run optimizations in the cloud
• Leaderboard Participation: Submit to public competitions
• Community Features: Share experiments and benchmarks
• API Access: Programmatic access via Python SDK

​

Profile Information

Your Rastion profile automatically includes:

• Username: Your GitHub username
• Email: Primary email from GitHub
• Full Name: Display name from GitHub
• Avatar: Your GitHub profile picture

​

Security and Privacy

​

What We Access

Rastion only accesses:

• Public profile information
• Public repository metadata (for repository browsing)
• No private repository content
• No write access to your GitHub repositories

​

Data Protection

• Secure Storage: All tokens are encrypted
• Limited Scope: Minimal permissions requested
• User Control: You can revoke access anytime via GitHub settings
• Privacy First: We don’t store unnecessary data

​

Troubleshooting

​

Common Issues

​

”Authorization Failed”

• Check that you clicked “Authorize” on GitHub
• Ensure your GitHub account has a verified email
• Try clearing browser cache and signing in again

​

”Token Not Found”

• Go to Settings and generate a new API token
• Make sure you’re copying the complete token
• Check that the token hasn’t expired

​

”Access Denied”

• Verify your GitHub account is in good standing
• Check if you have any GitHub restrictions
• Contact support if the issue persists

​

Getting Help

If you encounter issues:

1. Check GitHub Status: Ensure GitHub services are operational
2. Browser Issues: Try a different browser or incognito mode
3. Contact Support: Reach out via the platform’s support channels
4. Community Forum: Ask questions in the community discussions

​

Next Steps

​

API Token Management

​

Best Practices

• Keep Secure: Never share your API token publicly
• Environment Variables: Store in environment variables for scripts
• Regular Rotation: Generate new tokens periodically
• Scope Limitation: Use tokens only for intended purposes

​

Using Your Token

# Method 1: Direct authentication
import qubots.rastion as rastion
rastion.authenticate("your_token_here")

# Method 2: Environment variable
import os
os.environ['RASTION_API_TOKEN'] = 'your_token_here'

# Method 3: Configuration file
# Add to ~/.qubots/config.yaml:
# rastion:
#   api_token: "your_token_here"

Welcome to the Rastion community! Your GitHub authentication gives you access to a powerful platform for optimization research and collaboration.