Follow these steps to get Agent-Corex running locally. All commands have copy buttons!
1 Clone Repository
Clone Agent-Corex from GitHub
git clone https://github.com/ankitpro/agent-corex.git
cd agent-corex2 Create Virtual Environment
Create isolated Python environment
python -m venv venv
source venv/bin/activatepython -m venv venv
venv\Scripts\activate3 Install Dependencies
Install Agent-Corex package
pip install -e .4 Start Backend
Launch the FastAPI server
uvicorn agent_core.api.main:app --reload✅ Server runs on http://localhost:8000
5 Test Connection
Switch to Connection tab and click "Test Connection"
Status: Disconnected
💡 Tip: If "Test Connection" fails when your backend is running locally, try clicking "Clear Settings" first. This clears cached connection state and often resolves connection issues.
📚 What is Agent-Corex?
Agent-Corex is an advanced framework for building autonomous AI agents with intelligent tool retrieval and execution capabilities.
Key Features:
- Smart Tool Retrieval: Semantic search to find the right tools for any task
- Multiple Ranking Methods: Keyword, embedding, and hybrid search strategies
- Local Deployment: Run privately on your machine with no external dependencies
- Extensible Architecture: Add custom tools and integrate with existing systems
How It Works:
- You describe what you want to do (e.g., "edit a file")
- Agent-Corex searches its tool registry for relevant tools
- Tools are ranked by relevance using advanced algorithms
- The most relevant tools are returned for your use
Getting Started: Follow the Setup Guide tab to get Agent-Corex running locally, then use the Query Tools tab to search for tools.
⚠️ Backend Not Connected
To use Query Tools, you need to:
1. Go to Connection tab
2. Enter your backend URL (e.g., http://localhost:8000)
3. Click "Test Connection" to verify it works
4. Come back here to search tools
→ Go to Connection Tab
To use Query Tools, you need to:
1. Go to Connection tab
2. Enter your backend URL (e.g., http://localhost:8000)
3. Click "Test Connection" to verify it works
4. Come back here to search tools
→ Go to Connection Tab