init: add readme and initialise package

.python-version

@@ -0,0 +1 @@
+3.13

README.md

@@ -1,2 +1,51 @@
-# deepengineer
-Deepsearch focused on scientific questions
+# DeepEngineer 🔬
+
+> A deep search agentic system for scientific and engineering workflows
+
+## 🎯 About
+
+DeepEngineer is an open-source project designed to build a specialized agentic system that assists engineers and scientists. The ultimate vision is to create an AI agent that can reason, plan, and execute complex tasks, effectively augmenting and accelerating the engineering and scientific workflow.
+
+### 🚀 Vision
+
+The project is inspired by the outstanding challenge in AI to address the complexities of numerical simulation-intensive science and engineering. As noted in recent research, this requires a sophisticated composition of scientific reasoning with the ability to operate specialized software and tools.
+
+> *"Addressing the degree of complexity required in numerical simulation-intensive science and engineering workflows – which requires the composition of scientific reasoning with the ability to operate simulation software – remains an outstanding challenge."*
+> — [FEABench: Evaluating Language Models on Multiphysics
+Reasoning Ability](https://arxiv.org/abs/2504.06260)
+
+This project aims to tackle this challenge by creating an agent with the following core capabilities:
+
+### ⚙️ Current objective
+
+It is likely that this project will not be better than the non specialized deepsearch solutions like OpenAI's or Magnus on scientific questions. Even though those solutions tend to focus on software development, they are generally very good at everything.
+
+That being said, I hope to learn a lot and I see it as a personal challenge to deploy this solution and then iterate on it. Well see.
+
+## Getting starded
+
+## Installation
+
+```bash
+git clone https://github.com/your_username_/DeepEngineer.git
+cd DeepEngineer
+uv sync
+```
+
+### 🛠️ Tool Use
+
+The minimum tools needed are:
+- Web crawler agent
+- Scientific paper analyser agent
+- Drawing agent
+- Coding Agent 
+
+### Packages used
+- smolagents
+- crawl4ai
+
+### External APIs
+- Mistral (OCR)
+- Deepseek (LLM)
+- Perplexity / Talily / Wikipedia / Arxiv
+

pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "deepengineer"
+version = "0.1.0"
+description = "DeepEngineer is a deepsearch project focused on engineering"
+readme = "README.md"
+authors = [
+    { name = "Charles Azam", email = "azamcharles0@gmail.com" }
+]
+requires-python = ">=3.13"
+dependencies = []
+
+[project.scripts]
+deepengineer = "deepengineer:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"

src/deepengineer/__init__.py

@@ -0,0 +1,3 @@
+def main() -> None:
+    print("Hello from deepengineer!")
+