You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Cipher Academy is a sophisticated, browser-based educational environment designed to demystify offensive security concepts and Python programming. Built with React and TypeScript, it provides a safe, isolated sandbox where users can practice penetration testing methodologies, analyze vulnerabilities, and execute Python scripts directly in the browser.
The platform operates as a **Progressive Web App (PWA)**, ensuring full offline capabilities and native-like performance on mobile devices. It leverages a hybrid execution engine:
8
+
| Component | Implementation | Notes |
9
+
| :--- | :--- | :--- |
10
+
|**Runtime**| Pyodide / Web Workers | Isolates code execution from the main thread |
11
+
|**Shell**| Virtualized Terminal | Simulates Kali Linux environment commands |
12
+
|**Storage**| IndexedDB | Offline persistence for user progress |
***Virtual Terminal:** A simulated Kali Linux shell environment.
11
-
***Python Runtime:** Browser-based Python execution via Web Workers (Pyodide), allowing real-time code analysis without server-side dependencies.
12
-
***AI Tutor:** Integrated Gemini AI assistance for code auditing and logic explanation.
15
+
## Core Modules
13
16
14
-
## Key Features
17
+
1.**Curriculum**
18
+
* Python Syntax & Logic
19
+
* Network Reconnaissance (Socket programming)
20
+
* Exploit Development (Keyloggers, ARP logic)
15
21
16
-
### 1. Interactive Learning Roadmap
17
-
A structured curriculum guiding users from basic Python syntax to advanced exploit development. Content is delivered in Amharic to bridge the language gap in cybersecurity education.
This project is designed to be deployed as a static site or installed as a PWA.
34
+
Standard Vite project structure.
41
35
42
36
```bash
43
37
# Install dependencies
44
38
npm install
45
39
46
-
# Start development server
40
+
# Start local server
47
41
npm run dev
48
42
49
43
# Build for production
@@ -52,8 +46,8 @@ npm run build
52
46
53
47
## Deployment
54
48
55
-
The application is configured for automated deployment via GitHub Actions. Pushing to the `main`branch triggers a build process that generates a production-ready artifact hosted on GitHub Pages.
49
+
Configured for GitHub Pages. Pushing to `main` triggers the build workflow via GitHub Actions.
0 commit comments