README.md

metadata

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

Proxy-lite Salesforce Automation

A Salesforce automation system using Proxy-lite that works with any Salesforce org. The backend is already deployed and ready to use - you just need to add the Lightning Web Component to your org.

✅ What You Need

• A Salesforce org (any org)
• Salesforce CLI (sfdx)
• Your Salesforce username and password

🚀 Quick Setup (5 minutes)

Step 1: Deploy the Lightning Web Component

# Clone this repository
git clone [your-repo-url]
cd proxy-litev2\ copy

# Deploy to your Salesforce org
cd proxy-lite-work
sfdx force:auth:web:login -a yourorg
sfdx force:source:push -u yourorg

Step 2: Add Component to Your Page

1. Go to Setup → Lightning App Builder
2. Edit any Lightning page (like Home page)
3. Add the "Salesforce Automation with Proxy Lite" component
4. Save and activate

Step 3: Use the Component

1. Open the Lightning page where you added the component
2. Select a target page from the dropdown
3. Enter your automation task (e.g., "Enable the toggle switch")
4. Click "Run Automation"

That's it! The component will connect to the already-deployed backend automatically.

🔧 How It Works

• Backend: Already deployed on Hugging Face Spaces (no setup needed)
• Frontend: Lightning Web Component in your Salesforce org
• Authentication: Uses your Salesforce credentials automatically
• URLs: Dynamically adapts to your org's domain

📋 Supported Automation Tasks

The system can automate various Salesforce setup pages:

• Warranty Lifecycle Management
• Account Forecasting Settings
• Sales Agreements
• Account Manager Targets
• Custom tasks on any setup page

🛠️ Advanced Configuration (Optional)

Custom Endpoint (Enterprise Users)

If you need your own private instance:

1. Fork this repository

2. Deploy to Hugging Face Spaces:

   • Create a new Space
   • Connect your forked repo
   • Set environment variables:

     GEMINI_API_KEY=your_key
     SALESFORCE_USERNAME=your_username  
     SALESFORCE_PASSWORD=your_password
     

3. Update Apex Class:

   • Go to Setup → Apex Classes → ProxyLiteService
   • Update the endpoint URL in getProxyLiteEndpoint() method

Environment Variables for Custom Deployment

Only needed if deploying your own instance:

# Required: At least one API key
GEMINI_API_KEY=your_gemini_api_key
HF_API_TOKEN=your_hf_token

# Required: Your Salesforce credentials  
[email protected]
SALESFORCE_PASSWORD=your_salesforce_password

# Optional: Browser settings
BROWSER_HEADLESS=true
BROWSER_VIEWPORT_WIDTH=1280
BROWSER_VIEWPORT_HEIGHT=720

🔍 Troubleshooting

Common Issues

1. Component not showing: Check if you've pushed the LWC to your org
2. "Endpoint not configured" error: The Apex class needs the correct endpoint URL
3. Authentication errors: Verify your Salesforce credentials work
4. Timeout errors: Large tasks may take time - be patient

Debug Steps

1. Check browser console for errors
2. Verify the LWC is properly deployed
3. Test with a simple task first
4. Check Salesforce debug logs

💡 Why This Approach?

• No Python setup needed - Backend already deployed
• Works with any Salesforce org - No hardcoded URLs
• Free to use - Powered by Hugging Face Spaces
• Secure - Uses your org's authentication
• Simple deployment - Just add the LWC component

🆘 Support

If you encounter issues:

1. Check the troubleshooting section above
2. Verify your Salesforce org permissions
3. Test with a different browser
4. Check the component is properly added to your page

📄 License

This project is licensed under the MIT License.