📦 NEW: First commit

Author: msaaddev

.env.example

@@ -0,0 +1,19 @@
+# Langbase API credentials
+LANGBASE_API_KEY=your_langbase_api_key_here
+
+# Optional: Provider-specific API keys for various services
+# LLM provider keys
+ANTHROPIC_API_KEY=your_anthropic_key_here
+OPENAI_API_KEY=your_openai_key_here
+GOOGLE_AI_API_KEY=your_google_key_here
+
+# Tool provider keys
+CRAWL_KEY=your_spider_cloud_key_here
+EXA_API_KEY=your_exa_key_here
+
+# Custom base URL (optional)
+# LANGBASE_BASE_URL=https://eu-api.langbase.com
+
+# Development settings
+DEBUG=false
+TIMEOUT=30

.gitignore

@@ -0,0 +1,110 @@
+# Python-specific
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# VS Code
+.vscode/
+*.code-workspace
+
+# PyCharm
+.idea/
+*.iml
+*.iws
+*.ipr
+*.iws
+.idea_modules/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Documentation
+_build/
+site/
+
+# macOS
+.DS_Store
+.AppleDouble
+.LSOverride
+Icon
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+
+# Windows
+Thumbs.db
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+*.lnk
+
+# Credential files and logs
+*.log
+credentials.json
+token.json
+
+# Test files
+test_output/
+temp/
+tmp/
+
+# Local environment configuration
+.env.local
+.env.development
+.env.test
+.env.production
+
+# MyPy cache
+.mypy_cache/

Makefile

@@ -0,0 +1,75 @@
+.PHONY: clean clean-build clean-pyc help test lint format build
+.DEFAULT_GOAL := help
+
+define PRINT_HELP_PYSCRIPT
+import re, sys
+
+for line in sys.stdin:
+	match = re.match(r'^([a-zA-Z_-]+):.*?## (.*)$$', line)
+	if match:
+		target, help = match.groups()
+		print("%-20s %s" % (target, help))
+endef
+export PRINT_HELP_PYSCRIPT
+
+help:
+	@python -c "$$PRINT_HELP_PYSCRIPT" < $(MAKEFILE_LIST)
+
+clean: clean-build clean-pyc ## remove all build, test, coverage and Python artifacts
+
+clean-build: ## remove build artifacts
+	rm -fr build/
+	rm -fr dist/
+	rm -fr .eggs/
+	find . -name '*.egg-info' -exec rm -fr {} +
+	find . -name '*.egg' -exec rm -f {} +
+
+clean-pyc: ## remove Python file artifacts
+	find . -name '*.pyc' -exec rm -f {} +
+	find . -name '*.pyo' -exec rm -f {} +
+	find . -name '*~' -exec rm -f {} +
+	find . -name '__pycache__' -exec rm -fr {} +
+
+lint: ## check style with flake8
+	flake8 langbase tests examples
+
+format: ## format code with black and isort
+	black langbase tests examples
+	isort langbase tests examples
+
+test: ## run tests
+	pytest
+
+test-cov: ## run tests with coverage report
+	pytest --cov=langbase --cov-report=term --cov-report=html
+
+venv: ## create virtual environment
+	python -m venv venv
+	@echo "Run 'source venv/bin/activate' to activate the virtual environment"
+
+dev-install: ## install the package in development mode
+	pip install -e ".[dev]"
+
+build: clean ## build the package
+	python -m build
+
+publish-test: build ## publish package to TestPyPI
+	twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+
+publish: build ## publish package to PyPI
+	twine upload dist/*
+
+install-test: ## install package from TestPyPI
+	pip install --index-url https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple langbase
+
+examples: ## run examples
+	@echo "Running examples..."
+	@for example in $(shell find examples -name "*.py" | sort); do \
+		echo "\nRunning $${example}:"; \
+		python $${example}; \
+	done
+
+docs: ## generate Sphinx documentation
+	sphinx-apidoc -o docs/source langbase
+	$(MAKE) -C docs clean
+	$(MAKE) -C docs html