setup_guide.md

Complete Setup Guide

Follow this guide to get the AgentSourcing platform running on your local machine.

Prerequisites

• Python 3.10+
• Node.js 18+ (for building the frontend)
• A Circle developer account (https://console.circle.com)
• A Featherless.ai account (https://featherless.ai)

1. Clone & Install

cd AgentSourcing
pip install -r requirements.txt

# Build the frontend UI
cd frontend && npm install && npm run build && cd ..

2. Environment Variables

Copy the provided .env.example file to .env:

cp .env.example .env

3. Configure Circle Wallets

You need to set up your Circle Developer-Controlled Wallets to enable agent payouts.

1. Get your Circle API Key from the Circle Web3 Services Console.
2. Add it to your .env file under CIRCLE_API_KEY.
3. Run the secure setup script to generate your entity secret and wallet set:

python circle/setup.py

4. The script will output several IDs (CIRCLE_WALLET_SET_ID, CIRCLE_MANAGER_WALLET_ID, etc.). Copy these and paste them into your .env file.

4. Configure LLM

1. Get your Featherless.ai API Key.
2. Add it to .env under FEATHERLESS_API_KEY.
3. Each agent uses a specialized model tuned for its role:

Agent	Model
Manager (Orchestrator)	meta-llama/Meta-Llama-3.1-70B-Instruct
Scraper	meta-llama/Meta-Llama-3.1-8B-Instruct
Analyst	Qwen/Qwen2.5-Coder-32B-Instruct
Summarizer	mistralai/Mistral-Nemo-Instruct-2407
Fact-Checker	deepseek-ai/DeepSeek-R1-Distill-Llama-70B
Translator	huihui-ai/Qwen2.5-72B-Instruct-abliterated

5. Start the Server

Start the FastAPI server using Uvicorn:

python main.py

Alternatively:

uvicorn main:app --reload --host 0.0.0.0 --port 8000

6. Access the Dashboard

Open your web browser and navigate to: http://localhost:8000

You can now submit tasks and watch the agents collaborate in real-time!