![banner](https://private-user-images.githubusercontent.com/891585/250743681-4ea315e2-b496-4cfb-a81a-560a1763bf15.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjQ1NDA3MDIsIm5iZiI6MTcyNDU0MDQwMiwicGF0aCI6Ii84OTE1ODUvMjUwNzQzNjgxLTRlYTMxNWUyLWI0OTYtNGNmYi1hODFhLTU2MGExNzYzYmYxNS5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjQwODI0JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI0MDgyNFQyMzAwMDJaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lYjllZmI5NDM3NDAzZTU1YTcxZDg0MDM4ZTA1ZDQ5OTgxY2JmODg5NzYxNzJiMDJmZDdjNzU3NmE5YjY1M2ZkJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZhY3Rvcl9pZD0wJmtleV9pZD0wJnJlcG9faWQ9MCJ9.LQp-YF-qgkFAWzHhXamMEtXlntrSRvVkgAuSkDJ-mZ8)
BlockAGI is an open-source research agent built with Python3, utilizing the capabilities of LangChain and OpenAI. BlockAGI conducts iterative, domain-specific research, primarily focused on cryptocurrency but customizable to other domains. It outputs detailed narrative reports to showcase its findings. The progress of the AI agent's work is presented interactively through a user-friendly web interface, allowing users to watch the progress in real-time.
๐ค Initially designed to answer crypto research topics (hence the "Block" in BlockAGI), it has proven useful for a wide variety of other use cases.
- ๐ Automated Research: Just provide the topics, and let BlockAGI do the research.
- ๐ Comprehensive: BlockAGI can search, gather, refine, and evaluate information on its own.
- ๐ Live Data: BlockAGI can access real-time data from the internet or your own database.
- ๐ WebUI: Equipped with user-friendly interface, all in one
tsx
file. - ๐ฏ 100% Hackable: The code, based on LangChain, is concise and easy to modify to suit your needs.
- ๐ Privacy Focused: Your report stays with you and the LLM provider you trust.
- ๐ Inspired by the Best: BlockAGI builds upon the work of BabyAGI and AutoGPT to create a self-improving agent.
- โก Efficiency: BlockAGI has been tested to work well with
gpt-3.5-turbo-16k
, which is substantially cheaper thangpt-4
on most research tasks. - ๐ฅ๏ธ Interactive Web UI: BlockAGI features a Web UI that displays the agent's decision-making process, execution progress, and the latest research results. This allows for a more interactive and user-friendly experience.
- ๐ฏ Focused Functionality: BlockAGI is designed with a single goal in mind - to assist users in their research topics. It's not about doing everything, but doing one thing really well.
- ๐ง Simplified Setup: BlockAGI does not require file reading/writing, so there's no need for Docker/sandboxing. This makes the setup process simpler and more straightforward.
- ๐ฆ No External Datastore: BlockAGI does not require an external vector datastore to work, reducing the complexity and resource requirements.
We currently don't take any monetary donations! However, every issue filed and PR are extremely important to us. Here is the roster of contributors and supporters of the project.
- Installation and Basic Usage
- Parameters and Their Recommended Value
- BlockAGI's Architecture
- Design Choices
- Building Custom Tools
- Hacking Your Own Research Assitant (Advanced)
- Contributing to BlockAGI
To get started with BlockAGI, please follow these steps:
-
Install Poetry, a dependency management tool for Python.
-
Clone the BlockAGI repository to your local machine.
-
Navigate to the project directory and run the following command to install the required dependencies:
poetry install
-
Next, install the Playwright dependencies by running the following command:
poetry run playwright install
To start using BlockAGI, please follow these steps:
-
Copy the
.env.example
file and rename it to.env
. -
Open the
.env
file and add your OpenAI API key. You can also modify other configurations as needed, such as the research domain or any additional settings. -
Run the following command to start BlockAGI:
poetry run python main.py
This will initiate BlockAGI and also spin up a web application, allowing you to monitor the progress and interact with the research agent.
-
Watch the progress on BlockAGI via the web interface.
Contributions, feedback, and suggestions are highly encouraged and appreciated! You can contribute to BlockAGI in the following ways:
- Fork the repository and make modifications in your own branch. Then, submit a pull request (PR) with your changes.
- Submit issues (GitHub Issues) to report bugs, suggest new features, or ask questions.
- Join our Discord community and share your experiences, ideas, and improvements. We believe that collaborative development is essential for the growth of BlockAGI.
For BlockAGI code structure and contribution ideas, see CONTRIBUTING.md.
If you wish to cite BlockAGI in your research, we encourage the use of CITATION.cff provided for appropriate citation formatting. For more details on the citation file format, please visit the Citation File Format website.
BlockAGI is open-source software licensed under the Apache License 2.0. This license allows use, modification, and distribution of the software. For complete details, please see the LICENSE and NOTICE files in this repository.
We would like to express our gratitude to the following projects and communities for their inspiring work and valuable contributions: