In a world where data is like a never-ending ocean, Auto-Analyst emerges as your ship, ready to navigate through the waves of data analytics. This AI-driven agentic system simplifies the complex processes of data science, making it easier and more efficient for data analysts and scientists to work with data. This blog will guide you through the steps to set up and run Auto-Analyst locally, as well as provide troubleshooting tips along the way!
Key Features of Auto-Analyst
- Plug and Play Streamlit UI: An intuitive web interface that requires no extensive setup.
- Agents with Data Science Specialty: Various specialized agents handle tasks like data visualization, statistical analysis, machine learning, and data preprocessing.
- Completely Automated, LLM Agnostic: Functions with full automation, adaptable to any AI model.
- Built Using Lightweight Frameworks: Efficiently constructed with frameworks like DSPy, ensuring responsiveness.
How to Run Auto-Analyst Locally
Ready to set sail with Auto-Analyst? Follow these steps for installation:
Step 1: Clone the Repository
To get started, you’ll first need to clone the repository to your local machine using Git:
git clone https://github.com/ArslanS1997/Auto-Analyst.git
cd Auto-Analyst
Step 2: Install Dependencies
Create a virtual environment and install the necessary Python packages listed in the requirements.txt file:
python -m venv venv
source venv/bin/activate # On Windows use venv\Scripts\activate
pip install -r requirements.txt
Step 3: Set Up Environment Variables
For the app to function correctly, set up your OPENAI_API_KEY environment variable:
- Using .env file: Create a file named
.envin the root of your project with the following content:OPENAI_API_KEY=your_openai_api_key_here - Exporting in Terminal: Alternatively, you could export it in your terminal:
export OPENAI_API_KEY=your_openai_api_key_hereMake sure to replace
your_openai_api_key_herewith your actual key.
Step 4: Run the Streamlit App
Finally, launch the Streamlit app with this command:
streamlit run new_frontend.py
Understanding the System Files
The Auto-Analyst project has several essential files, each serving a unique purpose:
- agents.py: Defines AI agents that handle tasks like directing queries and summarizing responses.
- memory_agents.py: Contains agents dedicated to summarizing memory and code errors.
- retrievers.py: Manages data retrieval and processing, ensuring your data is clean and ready for analysis.
- new_frontend.py: The main script to run the application and unify all agents and functionalities.
Troubleshooting Tips
If you encounter issues while setting up or running Auto-Analyst, here are some handy troubleshooting ideas:
- Ensure that all dependencies are correctly installed by checking your virtual environment.
- If the app fails to start, double-check your
OPENAI_API_KEYto ensure it’s set correctly. - Use
streamlit run new_frontend.py --browser.serverAddress=0.0.0.0to allow access over a local network, if necessary.
For more insights, updates, or to collaborate on AI development projects, stay connected with fxis.ai.
In Conclusion
At fxis.ai, we believe that such advancements are crucial for the future of AI, as they enable more comprehensive and effective solutions. Our team is continually exploring new methodologies to push the envelope in artificial intelligence, ensuring that our clients benefit from the latest technological innovations.

