metadata

title: Proxy Lite Experimental
emoji: 🐨
colorFrom: green
colorTo: purple
sdk: docker
pinned: false

Proxy-lite Salesforce Automation with Single-Browser Login

This is a modernized proxy-lite Salesforce automation system that uses a streamlined single-browser login approach.

Key Features

✅ Single-Browser Login: No more cookie injection complexity ✅ Dual API Support: Works with both Gemini and Convergence AI ✅ Automatic Authentication: Handles Salesforce login seamlessly ✅ Efficient Architecture: One browser instance for login and task execution

Quick Start

Environment Setup

Install dependencies:

pip install -r requirements.txt

Set environment variables:

# API Keys (set at least one)
export GEMINI_API_KEY=your_gemini_api_key
export HF_API_TOKEN=your_hf_token

# Salesforce Credentials
export SALESFORCE_USERNAME=your_salesforce_username
export SALESFORCE_PASSWORD=your_salesforce_password

Run the Flask app:

python app.py

Usage

Send a POST request to /run_proxy_task:

{
  "task": "Navigate to the permission set and assign it to the user",
  "url": "https://your-org.salesforce.com/lightning/setup/AccountForecastSettings/home"
}

Architecture

The system automatically:

Initializes a browser session
Performs Salesforce login using provided credentials
Navigates to the target URL
Executes the requested task
Returns structured results

API Priority

Gemini API (preferred if GEMINI_API_KEY is set)
Convergence AI (fallback if only HF_API_TOKEN is set)

Benefits over Cookie Injection

Eliminates cookie extraction/injection complexity
More efficient (no separate browser instance)
Better session management
More reliable navigation
Easier to maintain and debug

See SINGLE_BROWSER_LOGIN_GUIDE.md for detailed documentation.