This repository has been archived on 2025-02-10. You can view files and clone it, but cannot push or open issues or pull requests.
lastin-ai/README.md
2025-02-01 00:03:38 +00:00

128 lines
3.6 KiB
Markdown

# [ Work in Progress ]
# 🤖 Last-In AI: Your Papers Please!
[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![arXiv](https://img.shields.io/badge/arXiv-2401.00000-b31b1b.svg)](https://arxiv.org)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
[![Docker](https://img.shields.io/badge/docker-ready-brightgreen.svg)](docker/README.md)
> *"Because reading research papers manually is so 2023!"* 🎯
## 🎭 What's This All About?
Last-In AI is your friendly neighborhood research paper analyzer that turns those dense academic PDFs into digestible insights. Think of it as your very own academic paper whisperer, but with more silicon and less caffeine.
## 🌟 Features
- 📚 **arXiv Integration**: Fetches papers faster than you can say "peer review"
- 🔍 **Smart Analysis**: Reads papers so you don't have to (but you probably should anyway)
- 📊 **PDF Processing**: Turns those pesky PDFs into structured data faster than a grad student's coffee run
- 🤹 **Orchestration**: Juggles multiple tasks like a circus professional
## 🏗️ Architecture
```
src/
├── analysis/ # Where the magic happens 🎩
├── data_acquisition/ # Paper fetching wizardry 📥
├── orchestration/ # The puppet master 🎭
└── processing/ # PDF wrestling championship 📄
docker/ # Container configuration 🐳
├── Dockerfile # Multi-stage build definition
├── docker-compose.yml # Service orchestration
└── README.md # Docker setup documentation
```
## 🚀 Getting Started
### Method 1: Local Installation
1. Clone this repository (because good things should be shared)
```bash
git clone https://git.stevanovic.co.uk/kpcto/lastin-ai.git
cd lastin-ai
```
2. Install dependencies (they're like friends, but for your code)
```bash
pip install -r requirements.txt
```
3. Set up your environment (like making your bed, but more technical)
```bash
cp .env.example .env
# Edit .env with your favorite text editor
```
### Method 2: Docker Installation 🐳
1. Clone and navigate to the repository
```bash
git clone https://git.stevanovic.co.uk/kpcto/lastin-ai.git
cd lastin-ai
```
2. Set up environment variables
```bash
cp .env.example .env
# Edit .env with your configuration
```
3. Build and run with Docker Compose
```bash
docker compose -f docker/docker-compose.yml up --build
```
For detailed Docker setup and configuration options, see [Docker Documentation](docker/README.md).
## 🎮 Usage
```python
from src.orchestration.agent_controller import AgentController
# Initialize the brain
controller = AgentController()
# Let it do its thing
controller.process_papers("quantum_computing")
# Now go grab a coffee, you've earned it!
```
## 🛠️ Development
### Running Tests
```bash
# Local
python -m pytest
# Docker
docker compose -f docker/docker-compose.yml run --rm app python -m pytest
```
### Environment Variables
- See `.env.example` for required configuration
- Docker configurations are documented in `docker/README.md`
## 🤝 Contributing
Found a bug? Want to add a feature? Have a brilliant idea? We're all ears!
Just remember:
1. Fork it 🍴
2. Branch it 🌿
3. Code it 💻
4. Test it 🧪
5. PR it 🎯
## 📜 License
MIT License - Because sharing is caring! See [LICENSE](LICENSE) for more details.
## 🎭 Fun Facts
- This README was written by an AI (plot twist!)
- The code is probably smarter than most of us
- We counted the coffee cups consumed during development, but lost count at 42
---
Made with 💻 and questionable amounts of ☕