Elijah

An Agentic Workbench for Family History Research

Overview

Elijah is an AI-powered workbench designed to assist with family history and genealogical research. It leverages agentic AI capabilities to help researchers organize, analyze, and discover insights in their family history data.

Features

• Coming soon

Installation

From PyPI

pip install elijah

From Source

git clone https://github.com/DecisionNerd/elijah.git
cd elijah
pip install -e .

Usage

After installation, you can run Elijah using the command line:

elijah

Or use it as a Python module:

from elijah import main

main()

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/DecisionNerd/elijah.git
cd elijah

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

Running Tests

pytest

Code Quality

# Run linting
ruff check .

# Run formatting
ruff format .

# Run type checking
mypy src/elijah

Requirements

• Python 3.13 or higher

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project Status

Elijah is currently in early development (Alpha stage). APIs and features may change significantly between versions.

Acknowledgments

Named after the prophet Elijah, who in Jewish tradition is said to attend every brit milah and Passover Seder, symbolizing the connection between generations and the importance of family legacy.