A lightweight task-management assistant project with an AI agent, a small database layer, and both CLI and GUI frontends.
- AI agent for task automation,agentic web search and helpers (
ai_agent/agent.py) - Simple database manager (
database/db_manager.py) with tests (test_db.py) - MCP server for integrations and automation (
mcp_server/server.py) - Command-line and graphical frontends (
ui/cli.py,ui/gui.py)
ai_agent/— AI agent implementation and orchestrationdatabase/— database utilities and managermcp_server/— lightweight server for automation/integrationui/— user interfaces: CLI and GUItest_db.py— simple database tests / example usagerequirements.txt— Python dependencies
- Python 3.9+
- See
requirements.txtfor Python packages. Create and activate a virtual environment before installing.
- Create & activate a virtual environment:
python -m venv .venv
source .venv/bin/activate- Install dependencies:
pip install -r requirements.txt- Run the database test (quick sanity check):
python test_db.py- Start the MCP server (if used for integrations):
python -m mcp_server.server- Run the AI agent (experimentally):
python -m ai_agent.agent- Launch the CLI:
python -m ui.cli- Launch the GUI (if implemented):
python -m ui.guiNotes:
- The concrete entrypoints above assume the modules expose runnable
if __name__ == '__main__'blocks. If not, run the appropriate helper scripts or import and call the exposed functions.
- Run tests and iterate. Use the virtual environment from above.
- Add features or fix bugs by editing the relevant package and creating small, focused commits.
Contributions are welcome. Please open issues or pull requests on the repository.
This project is provided as-is. Add a license file or replace this section with the chosen license (e.g., MIT).
