A lightweight, batteries-included Flask framework designed for rapidly building internal tools, admin panels, and data-driven web applications.
Soseki takes care of the repetitive infrastructure—authentication, database management, background jobs, API controls, and logging—so you can focus on building the features that matter. Perfect for prototypes, internal dashboards, and production-ready utilities that need to ship fast without sacrificing structure.
- 🔐 User Management - Complete authentication system with Flask-User
- 📊 Database Management - SQLAlchemy integration with dual database support (app + logs)
- ⏰ Job Scheduling - Background job execution with APScheduler
- 📧 Email Support - Built-in email functionality with Flask-Mail
- 🔌 API Gateway - API key management and rate limiting
- 📝 Request Logging - Comprehensive request/response logging
- 🛠️ Database Versioning - Built-in database migration support
- 🛠️ CLI - interactive command line for quick feature development and testing
- 🎨 Customizable - YAML-based configuration system
- Python 3.10 or higher
- Flask 3.0+
- SQLAlchemy 2.0+
pip install sosekigit clone https://github.com/acodingmind/soseki
cd soseki
pip install -e .pip install -r requirements.txt
pip install -r requirements-dev.txt- Initialize a new soseki like application:
# Create a project folder
mkdir soseki_app
cd soseki_app
# Install soseki
python3 -m venv venv
source venv/bin/activate
pip install soseki
# Initialize basic soseki app
python3 -m ssk.cli init- Update configuration file (
cfg/lite.yaml):
ssk:
USER_APP_NAME:
string: 'MyApp'
SECRET_KEY:
string: 'your-secret-key-here'
SQLALCHEMY_DATABASE_URI:
string: 'sqlite:///myapp.sqlite'
LOG_DB_CONNSTR:
string: 'sqlite:///myapp_log.sqlite'- Run your application:
# run the app
./bin/run_app.shCheck the app/ directory for a complete working example application.
The standard folder structure (created by init command):
assets/local- Static files (CSS, JS)blueprints/- Flask blueprintscfg/- Configuration fileshtml/local- Templateslogic/cmd- Custom commandslogic/jobs- Background jobsmodels/- Database models
soseki/
├── ssk/ # Core framework package
├── app/ # Blanco application
├── bin/ # Utility scripts
├── tests/ # Test suite
├── docs/ # Documentation
└── requirements.txt # Core dependencies
pytestWith coverage:
pytest --cov=sskMIT License - see LICENCE file for details.
Michał Świtała - CodingMinds.io
Contributions are welcome! Please feel free to submit a Pull Request.
For issues and questions, please use the GitHub issue tracker.